API d'incolonias

API REST per exportar les dades del programa de colònies felines i integrar-les amb la plataforma municipal de gestió de dades, un sistema GIS o un portal de dades obertes.

Especificació OpenAPI 3.0

Autenticació

Cada entitat crea les seves claus a «Configuració › API». Envia la clau a la capçalera:

Authorization: Bearer icol_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

Una clau només veu les dades de la seva entitat. Es pot revocar a l'instant. Límit: 600 peticions per minut.

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àmetres comuns:

• pagina, por_pagina (màxim 1000)
• modificado_desde=2026-11-01T00:00:00 — només el que s'ha creat o modificat des d'aquesta data, per sincronitzar per canvis
• id — un registre concret
• formato=json|csv|xml

Indicadors

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 oberts
• coste_anual — Coste del programa en el año
• evolucion_poblacion — Evolució de la població 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

Amb una clau amb permís «avisos», un altre sistema (el 010, la bústia ciutadana) pot 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}

Tipus admesos: gato_herido, gato_enfermo, gato_fallecido, camada, abandono, envenenamiento, conflicto_vecinal, suciedad, otro

Exemple

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", …}]
}