Política de compatibilidad
La API no tiene control de versiones de URL. En cambio, seguimos tres reglas para que las integraciones que ya están en producción no dejen de funcionar sin previo aviso:
- El nuevo comportamiento obtiene una nueva URL. Cuando el formato de los datos cambia, el punto final anterior continúa respondiendo exactamente como antes y el cambio se realiza en sentido contrario.
- Los campos se pueden agregar en cualquier momento. Trate la respuesta como un objeto abierto: ignore lo que no sabe en lugar de romperlo.
- Los terminales descontinuados permanecen en línea. Dejan la referencia, pero continúan respondiendo; la siguiente lista muestra el reemplazo de cada uno.
¿Tiene preguntas sobre algún cambio o necesita una fecha límite para migrar? escribir a contaovosdengue@gmail.com.
Puntos finales discontinuados
Todos continúan funcionando y devuelven exactamente el mismo contenido que antes. Simplemente no reciben nuevos campos.
| Punto final | Usar en su lugar | Razón |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | El nombre decía manzanas, pero el regreso siempre era de visitas a los mismos. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | Las EDL reciben mantenimiento, no visitas; los campos pasaron de edl_visit_* a edl_maintenance_*. |
Historial de cambios
2026-08-01
Nombres correctos para manzanas y mantenimiento EDL.
NoticiasDiscontinuación
- Nuevo
/api/getmunicipalityblocksvisitpublic — visitas realizadas por manzanas, con un registro por visita. Mismo contenido que el anterior. /api/getmunicipalityblockspublic, ahora con el nombre correcto. - Nuevo
/api/getmunicipalityblockspublic-2 — las manzanas en sí, un registro por manzana, con polígono, propiedades totales por tipo y participación promedio. - Nuevo
/api/getmunicipalityedlmaintenancepublic — Mantenimiento EDL, con los campos renombrados de edl_visit_* a edl_maintenance_*. - Interrumpido
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — siguen al aire, con la misma retroalimentación de siempre.
No es necesario cambiar las integraciones existentes. La migración solo se recomienda para aquellos que desean los nombres de campo correctos o los datos de las manzanas separados de las visitas.
2026-07-30
Ovitrampa rural y corrección de la semana epidemiológica
Noticias
/api/postcounting comenzó a aceptar ovitrap_type_id al instalar una ovitrampa: 1 para urbana (estándar, cuando no se envía el campo) y 2 para rural. Cualquier otro valor regresa 400 "Tipo de ovitrampa inválido".- Validación de la semana epidemiológica de
/api/postcounting e /api/postaction Pasó a comparar año y semana en conjunto. Anteriormente, una fecha de un año futuro con un número de semana bajo podía ser aceptada indebidamente.
2026-07-28
Nuevos puntos finales públicos para EDL, ovitrampas y puntos estratégicos
Noticias
/api/getmunicipalityedlspublic — EDL registradas por municipio./api/getmunicipalityovitrapspublic — ovitrampas registradas, con coordenadas y número promedio de huevos./api/getmunicipalityplacespublic — Puntos estratégicos, con tipo, subtipo y área.- Todos aceptan
country, state, municipality e page, como otros puntos finales públicos.
2026-04-23
Envío de visitas en manzanas
Noticias
- Nuevo
/api/postaction — registra una visita con las propiedades trabajadas y los depósitos encontrados por clase (a1, a2, b, c, d1, d2, e). - Envío
block_group_id en lugar de block_id, la manzana se crea automáticamente dentro del municipio de la clave. - Respuestas específicas:
403 cuando la manzana es de otro municipio y 409 cuando ya hay visita para ese manzana, año y semana.
2026-03-27
La clave ahora se lee desde la URL.
Cambio de comportamiento
En todos los puntos finales privados, el key comenzó a leerse exclusivamente desde la cadena de consulta (?key=SUA_CHAVE), incluso en la publicación. Las integraciones que solo enviaron la clave en el cuerpo del formulario comienzan a recibir 404 "Wrong key" — simplemente mueva la clave a la URL, manteniendo los demás campos en el cuerpo.
2026-02-24
Eliminación de visitas y manzanas
Noticias
/api/postdeleteaction — elimina la visita de una manzana, identificado por block_group_id e date./api/postdeleteblock — quitar la manzana.
2026-02-04
Filtrar por período en recuentos privados
Noticias
/api/lastcounting comenzó a aceptar date_start e date_end, permitiéndole reducir los recuentos por rango de fechas en lugar de desplazarse por cada página.
2025-10-19
Sincronización incremental en recuentos públicos
Noticias
/api/lastcountingpublic comenzó a aceptar id (sólo ocurrencias de ese identificador), date (fecha de inclusión) e date_collect (data de coleta). Estos filtros le permiten mantener una base reflejada sin degradar todo su historial.
2025-03-18
Filtrar por período en recuentos públicos
Noticias
/api/lastcountingpublic comenzó a aceptar date_start e date_end.
2025-03-06
Eliminación de ovitrampas
Noticias
/api/postdeleteovitrap — retira una ovitrampa del ovitrap_group_id, dentro del municipio de Chave.