Cómo usar el API

Ver ubicaciones y código postal Ver repositorio

Esta API ofrece datos en formato JSON sobre las provincias, cantones y distritos de Costa Rica. Puedes usarla para integrar información de ubicaciones en tus aplicaciones. Aquí tienes las instrucciones para interactuar con los diferentes endpoints.

Endpoints Disponibles

1. Provincias

Devuelve una lista de todas las provincias en formato JSON.

GET /provincias.json

Ejemplo de respuesta:

{
  "1": "San José",
  "2": "Alajuela",
  "3": "Cartago",
  "4": "Heredia",
  "5": "Guanacaste",
  "6": "Puntarenas",
  "7": "Limón"
}

2. Cantones

Devuelve una lista de los cantones según la provincia seleccionada.

GET /provincia/:provinciaId/cantones.json

Ejemplo de respuesta para provinciaId=1:

{
  "1": "Central",
  "2": "Escazú",
  "3": "Desamparados",
  ...
}

3. Distritos

Devuelve una lista de distritos según el cantón y la provincia seleccionada.

GET /provincia/:provinciaId/canton/:cantonId/distritos.json

Ejemplo de respuesta para provinciaId=1 y cantonId=1:

{
  "1": "Carmen",
  "2": "Merced",
  "3": "Hospital",
  ...
}

Para más información, consulta el repositorio en GitHub.