Obtener una lista de las ciudades

Obtiene una lista completa de todas las ciudades registradas en el sistema. Incluye información geográfica y códigos SIFEN para cada ciudad.

---

Entorno

URL base: https://api.guarani.app

Endpoint

GET /ciudades?page=1&limit=100

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/ciudades?page=1&limit=100" \
-H "x-api-key: Bearer <access_token>" \
-H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar <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 encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
page	Integer	No	Número de la página a solicitar. Por defecto es 1.
limit	Integer	No	Cantidad de resultados por página. Si no se especifica, el valor por defecto es 10.

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

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": [
    {
      "id": "67ef2e9f-0fa7-43e7-ad5e-87a694e56341",
      "codigo_sifen": "3556",
      "nombre": "SANTA RITA",
      "distrito": {
        "id": "78d49201-91f9-4e6c-aadb-4927f56767c0",
        "codigo_sifen": "209",
        "nombre": "SANTA RITA",
        "departamento": {
          "id": "750d3163-6a53-45df-b349-e8139d1ff3a9",
          "codigo_sifen": "11",
          "nombre": "ALTO PARANA"
        }
      }
    }
  ],
  "pagination": {
    "total_registros": 1,
    "pagina": 1,
    "total_paginas": 1
  }
}

Recursos adicionales

Para más información sobre posibles errores relacionados, consulta la sección errores.