{"openapi":"3.0.3","info":{"title":"API de incolonias","version":"1.0","description":"Exportación de datos e integración con plataformas municipales de gestión de datos. Cada clave pertenece a una entidad y solo ve sus datos."},"servers":[{"url":"https://app.incolonias.es"}],"components":{"securitySchemes":{"clave":{"type":"http","scheme":"bearer"}}},"security":[{"clave":[]}],"paths":{"/api/v1/colonias":{"get":{"summary":"Lista de colonias","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/gatos":{"get":{"summary":"Lista de gatos","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/actuaciones-clinicas":{"get":{"summary":"Lista de actuaciones-clinicas","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/intervenciones":{"get":{"summary":"Lista de intervenciones","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/recuentos":{"get":{"summary":"Lista de recuentos","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/avisos":{"get":{"summary":"Lista de avisos","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}},"post":{"summary":"Crear un aviso (requiere permiso «avisos»)","tags":["Integración"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["tipo","descripcion"],"properties":{"tipo":{"type":"string","enum":["gato_herido","gato_enfermo","gato_fallecido","camada","abandono","envenenamiento","conflicto_vecinal","suciedad","otro"]},"descripcion":{"type":"string"},"colonia_id":{"type":"integer"},"lat":{"type":"number"},"lon":{"type":"number"},"direccion":{"type":"string"},"nombre":{"type":"string"},"contacto":{"type":"string"}}}}}},"responses":{"201":{"description":"Aviso creado"},"422":{"description":"Datos no válidos"}}}},"/api/v1/zonas":{"get":{"summary":"Lista de zonas","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/organizaciones":{"get":{"summary":"Lista de organizaciones","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/material":{"get":{"summary":"Lista de material","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/movimientos-material":{"get":{"summary":"Lista de movimientos-material","tags":["Exportación"],"parameters":[{"name":"pagina","in":"query","schema":{"type":"integer","default":1}},{"name":"por_pagina","in":"query","schema":{"type":"integer","default":100,"maximum":1000}},{"name":"modificado_desde","in":"query","description":"Solo registros creados o modificados desde esa fecha (sincronización incremental).","schema":{"type":"string","format":"date-time"}},{"name":"id","in":"query","schema":{"type":"integer"}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv","xml"],"default":"json"}}],"responses":{"200":{"description":"Página de resultados"},"401":{"description":"Clave no válida"},"429":{"description":"Límite de peticiones"}}}},"/api/v1/estadisticas/{indicador}":{"get":{"summary":"Indicador del programa (series y repartos)","tags":["Indicadores"],"parameters":[{"name":"indicador","in":"path","required":true,"schema":{"type":"string","enum":["colonias","gatos","esterilizados","pct_esterilizados","avisos_abiertos","coste_anual","evolucion_poblacion","esterilizaciones_mes","altas_bajas_mes","coste_mes","recuentos_mes","cer_estados","gatos_por_zona","sexo","intervenciones_tipo","incidencias_tipo","adoptables","colonias_estado","proyeccion"]}},{"name":"meses","in":"query","schema":{"type":"integer","default":12}},{"name":"zona_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Valor o series del indicador"}}}}}}