Referencia de la APIPuestos
Listar
Descripcion general
Este endpoint permite obtener un listado paginado de los puestos pertenecientes a tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Los puestos eliminados se excluyen automáticamente. El tamaño de página es fijo en 20 resultados.
Las bandas salariales (salary_band_min, salary_band_max) se serializan como strings decimales (por ejemplo "15000.00") para preservar la precisión.
Endpoint
GET
https://app.integranom.com/api/v1/job-positionsConsulta multiples puestos
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
active | "true" | "false" | No | - | Filtra por el flag is_active. |
Consulta un puesto especifico
Se puede buscar un puesto particular por su número, nombre o código. Los tres filtros hacen coincidencia exacta sin distinguir mayúsculas y minúsculas: el nombre y el código se almacenan en mayúsculas y el filtro se compara también en mayúsculas.
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
job_position_number | integer | No | - | Filtra por número de puesto exacto. |
name | string | No | - | Filtra por nombre exacto. |
code | string | No | - | Filtra por código exacto (almacenado en mayúsculas). |
Errores
| Status | Causa |
|---|---|
400 | Valor inválido en job_position_number o active. |
401 | API key ausente o inválida. |
403 | La API key no tiene el permiso getJobPositions. |