Obtener departamento por su ID
Obtiene información detallada de un departamento específico usando su ID único. Incluye nombre y código SIFEN del departamento.
Entorno
Sección titulada «Entorno»URL base: https://api.guarani.app
Endpoint
Sección titulada «Endpoint»GET /departamentos/{id}Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X GET "https://api.guarani.app/departamentos/{id}" \-H "x-api-key: Bearer <access_token>" \-H "Accept: application/json" | jqNota: Asegúrate de reemplazar
{id}con el identificador único del departamento y<access_token>con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezadox-api-keypara autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.
Parámetros de ruta
Sección titulada «Parámetros de ruta»| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id | uuid | Si | ID del Departamento para obtener sus datos. ver (departamentos) |
Encabezados de la Solicitud
Sección titulada «Encabezados de la Solicitud»| Encabezado | Valor | Descripción |
|---|---|---|
x-api-key | Bearer <access_token> | Token de autenticación necesario para acceder al recurso. |
Accept | application/json | Indica que la respuesta debe devolverse en formato JSON. |
Ejemplo de respuesta
Sección titulada «Ejemplo de respuesta»{ "success": true, "codigo": "200", "message": "Operación realizada correctamente.", "data": { "id": "40b24d7a-28b1-4fee-87da-a10e01bd8bfc", "codigo_sifen": 1, "nombre": "CAPITAL" }}Recursos adicionales
Sección titulada «Recursos adicionales»Para obtener más información sobre posibles errores relacionados con los departamentos y cómo manejarlos, consulta la sección de errores.