Playground interactivo

Prueba la API directamente desde tu navegador. Selecciona una plantilla o escribe tu propia consulta.

GET /api
Ejemplos:
Status: 200 OK 0ms
Cargando...

Documentaci贸n de endpoints

Detalle de las rutas disponibles en la API para integrar en tus aplicaciones.

GET /api/regions

Obtiene la lista completa de todas las regiones de Chile ordenadas territorialmente.

GET /api/regions/:identifier

Obtiene los detalles de una regi贸n espec铆fica usando su ID num茅rico (ej. 13) o su alias/c贸digo ISO (ej. rm, v, valparaiso).

GET /api/communes

Obtiene todas las comunas de Chile o filtra la lista completa mediante par谩metros de consulta (query params):

  • search o name: b煤squeda parcial por nombre (ej. /api/communes?search=vi帽a).
  • postal_code: filtro exacto por c贸digo postal (ej. ?postal_code=2520000).
  • region_id: comunas de una regi贸n espec铆fica (ej. ?region_id=5).
  • commune_id: filtro exacto por ID territorial de la comuna (ej. ?commune_id=5101).
GET /api/communes/:regionIdentifier

Obtiene todas las comunas pertenecientes a una regi贸n espec铆fica, buscada por su ID de regi贸n o su alias.

Ejemplo de integraci贸n

Consumir la API desde tu aplicaci贸n JavaScript es sumamente sencillo usando fetch API.

// Obtener comunas de la regi贸n de Coquimbo
fetch('https://chireco.vercel.app/api/communes/coquimbo')
  .then(response => response.json())
  .then(data => {
    console.log("Comunas de Coquimbo:", data);
  })
  .catch(error => console.error("Error al cargar comunas:", error));