Documentación de la API

GeoJSON listo para Leaflet/Mapbox. Endpoints idempotentes, GET-only. v1 recomendada; las rutas legacy de /api/* siguen activas como fallback.

API base https://chartismx.com/api/v1

Probar en la demo FAQ

Quickstart

Leaflet

// JS (ejemplo básico)
fetch('https://chartismx.com/api/v1/geometrias?layer=municipio&entidad=19&municipio=039')
  .then(r => r.json())
  .then(geo => L.geoJSON(geo).addTo(map));

cURL

curl "https://chartismx.com/api/v1/secciones/lookup?lat=25.67&lng=-100.31"

curl "https://chartismx.com/api/v1/secciones/por-municipio?entidad=19&municipio=039"

Endpoints

Método	Ruta	Descripción	Parámetros
GET	`/api/v1/entidades`	Lista entidades	—
GET	`/api/v1/meta`	Capacidades y catálogo de endpoints	—
GET	`/api/v1/meta/capas`	Parámetros requeridos por capa	—
GET	`/api/v1/health`	Estado operativo (incluye check de BD)	—
GET	`/api/v1/entidades/{entidad}/distritos`	Distritos por entidad	`entidad`
GET	`/api/v1/entidades/{entidad}/municipios`	Municipios por entidad	`entidad`
GET	`/api/v1/entidades/{entidad}/municipios/{municipio}/localidades`	Localidades por municipio	`entidad, municipio`
GET	`/api/v1/entidades/{entidad}/municipios/{municipio}/colonias`	Colonias por municipio	`entidad, municipio`
GET	`/api/v1/entidades/{entidad}/secciones`	Secciones por entidad	`entidad`
GET	`/api/v1/entidades/{entidad}/resumen`	Conteos de cobertura por entidad	`entidad`
GET	`/api/v1/geometrias`	GeoJSON por capa	`layer` + llaves (ver abajo)
GET	`/api/v1/geometrias/extent`	BBox de una geometría para fitBounds rápido	`layer` + llaves de filtro
GET	`/api/v1/secciones/labels`	Labels materializados (opcional)	—
GET	`/api/v1/secciones/por-municipio`	Secciones de un municipio	`entidad, municipio`
GET	`/api/v1/secciones/por-distrito`	Secciones de un distrito	`entidad, distrito`
GET	`/api/v1/secciones/por-localidad`	Secciones que tocan una localidad	`entidad, municipio, localidad`
GET	`/api/v1/secciones/por-colonia`	Secciones que tocan una colonia (GID)	`entidad, municipio, colonia`
GET	`/api/v1/secciones/lookup`	Punto → sección	`lat, lng`
GET	`/api/v1/contexto/punto`	Contexto administrativo del punto	`lat, lng`

Parámetros por capa (`geometrias`)

GeoJSON por capa

layer=entidad → entidad
layer=distrito → entidad, distrito
layer=municipio → entidad, municipio
layer=localidad → entidad, municipio, localidad
layer=colonia → entidad, municipio, colonia(gid)
layer=seccion → entidad, seccion

Point → Sección

Si el punto cae en borde, se aplica un buffer de 5 m (EPSG:3857) como fallback.

GET https://chartismx.com/api/v1/secciones/lookup?lat=25.67&lng=-100.31

Autenticación

Si necesitas token para entornos públicos, escríbenos a hola@chartismx.com. Habilitamos claves y rate limits por proyecto.

CORS

En producción limita Access-Control-Allow-Origin a tus dominios (p. ej. https://chartismx.com). Las peticiones GET admiten preflight OPTIONS.

Estado del servicio

Endpoint de salud:

GET https://chartismx.com/status

Endpoints avanzados recomendados

GET https://chartismx.com/api/v1/meta

Útil para discovery automático en frontends/SDKs.

GET https://chartismx.com/api/v1/entidades/19/resumen

Regresa conteos de municipios, distritos, secciones, colonias y localidades.

GET https://chartismx.com/api/v1/geometrias/extent?layer=municipio&entidad=19&municipio=39

Ideal para centrar mapas sin descargar geometrías pesadas primero.

GET https://chartismx.com/api/v1/health

Monitoreo técnico con verificación de base de datos.

Probar demo Solicitar cotización