Listar departamentos
GET
/api/v1/departments Devuelve los departamentos de tu empresa, en orden alfabético, cada uno con su número de empleados y su departamento supervisor —el que tiene por encima en el organigrama (null si es raíz)—. La respuesta se pagina (25 por página, máximo 100) e incluye un objeto meta con page, page_size y total.
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | integer | No | Página (desde 1). |
page_size | integer | No | Departamentos por página (máx. 100). |
Ejemplo
Sustituye db_live_tu_clave por tu clave.
curl -s -H "Authorization: Bearer db_live_tu_clave" \
"https://api.dutybeat.com/api/v1/departments?page_size=3" | jqRespuesta de ejemplo
Lo que imprime cada snippet al ejecutarlo: cURL devuelve el JSON crudo; los snippets de Python y PowerShell piden campos concretos, así que su salida es la de cada uno.
{
"data": [
{
"id": "dept-admin",
"name": "Administración y Finanzas",
"employee_count": 2,
"supervisor": {
"id": "dept-dir",
"name": "Dirección General"
},
"created_at": "2015-01-01T00:00:00Z"
},
{
"id": "dept-delc",
"name": "Delegación A Coruña",
"employee_count": 1,
"supervisor": {
"id": "dept-dir",
"name": "Dirección General"
},
"created_at": "2015-01-01T00:00:00Z"
},
{
"id": "dept-delm",
"name": "Delegación Madrid",
"employee_count": 1,
"supervisor": {
"id": "dept-dir",
"name": "Dirección General"
},
"created_at": "2015-01-01T00:00:00Z"
}
],
"meta": {
"page": 1,
"page_size": 3,
"total": 11
}
}