API de incolonias

API REST para exportar los datos del programa de colonias felinas e integrarlos con la plataforma municipal de gestión de datos, un sistema GIS o un portal de datos abiertos.

Especificación OpenAPI 3.0

Autenticación

Cada entidad crea sus claves en «Ajustes › API». Envía la clave en la cabecera:

Authorization: Bearer icol_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Si tu sistema no puede enviar esa cabecera, usa X-API-Key con la misma clave.

Una clave solo ve los datos de su entidad. Se puede revocar al instante. Límite: 600 peticiones por minuto.

Recursos

• GET /api/v1/colonias
• GET /api/v1/gatos
• GET /api/v1/actuaciones-clinicas
• GET /api/v1/intervenciones
• GET /api/v1/recuentos
• GET /api/v1/avisos
• GET /api/v1/zonas
• GET /api/v1/organizaciones
• GET /api/v1/material
• GET /api/v1/movimientos-material

Parámetros comunes:

• pagina, por_pagina (máximo 1000)
• modificado_desde=2026-11-01T00:00:00 — solo lo creado o modificado desde esa fecha, para sincronizar por cambios
• id — un registro concreto
• formato=json|csv|xml

Indicadores

GET /api/v1/estadisticas/{indicador}?meses=12&zona_id=

• colonias — Colonias activas
• gatos — Gatos censados presentes
• esterilizados — Gatos esterilizados
• pct_esterilizados — % de esterilización
• avisos_abiertos — Avisos abiertos
• coste_anual — Coste del programa en el año
• evolucion_poblacion — Evolución de la población censada
• esterilizaciones_mes — Esterilizaciones por mes
• altas_bajas_mes — Altas y bajas en el censo por mes
• coste_mes — Coste de intervenciones por mes
• recuentos_mes — Pases de lista por mes
• cer_estados — Gatos por estado CER
• gatos_por_zona — Gatos y esterilizados por zona
• sexo — Gatos por sexo
• intervenciones_tipo — Intervenciones por tipo (12 meses)
• incidencias_tipo — Avisos por tipo (12 meses)
• adoptables — Gatos por adoptabilidad
• colonias_estado — Colonias por estado
• proyeccion — Proyección de población (5 años)

Crear avisos

Con una clave con permiso «avisos», otro sistema (el 010, el buzón ciudadano) puede crear avisos:

POST /api/v1/avisos
Content-Type: application/json

{"tipo": "gato_herido", "descripcion": "Gato cojeando junto al parque", "lat": 41.542, "lon": 2.267}

Tipos admitidos: gato_herido, gato_enfermo, gato_fallecido, camada, abandono, envenenamiento, conflicto_vecinal, suciedad, otro

Ejemplo

curl -H "Authorization: Bearer $CLAVE" "https://app.incolonias.es/api/v1/colonias?por_pagina=100"

{
  "recurso": "colonias", "total": 21, "pagina": 1, "paginas": 1, "por_pagina": 100, "siguiente": null,
  "datos": [{"id": 1, "codigo": "COL-0001", "nombre": "…", "lat": 41.54, "lon": 2.26, "utm_x": 438861.13, "utm_y": 4599186.41, "utm_huso": 31,
             "gatos_presentes": 12, "gatos_esterilizados": 9, "estado": "autorizada", …}]
}