API de conteo de huevos

Consulta y envía datos de ovitrampas, bloques y visitas de campo directamente desde tu sistema. Esta página documenta todos los puntos finales públicos y privados disponibles.

/es-py/apiSolicitar clave API

Acerca de la API

Esta API tiene puntos finales público y privado. La API pública devuelve datos sobre latitud, longitud y número de huevos de cada municipio participante a lo largo del tiempo, sin necesidad de autenticación. La API privada solo se recomienda para aplicaciones que funcionan en asociación con Conta Ovos, ya que expone datos confidenciales y le permite insertar, cambiar y eliminar registros.

Autenticación y claves

Para utilizar la API privada necesitarás una clave de acceso. (key). Para adquirirlo envía un email a contaovosdengue@gmail.com indicando:

  • ¿Por qué necesita acceso API?
  • Qué nivel de acceso se requiere (municipal, regional, estatal o nacional);
  • ¿De qué región geográfica eres parte?

La clave se compone de 45 letras al azar y debe ser enviado en el parámetro key de cada solicitud privada. El alcance geográfico y el plan vinculado a la clave. (api_access_municipality_id, state_id, region_id, country_id, plan) define automáticamente qué registros puede leer o cambiar; una clave municipal, por ejemplo, solo puede leer o modificar datos del propio municipio.

Dónde enviar la clave: a key siempre se lee desde la cadena de consulta URL (?key=SUA_CHAVE), incluidos los puntos finales POST. Enviarlo solo en el cuerpo del formulario da como resultado 404 "Wrong key". Los demás campos POST siguen apareciendo en el cuerpo de la solicitud.
Paginación: los parametros page acepte un máximo de 100 en puntos finales que admitan paginación. Los valores no válidos o faltantes toman la página 1.

Códigos de respuesta

Todos los puntos finales siguen el mismo patrón de estado HTTP:

CódigoSignificado
200Solicitud procesada exitosamente.
400Falta el parámetro obligatorio o tiene un formato no válido.
403El recurso informado no pertenece al alcance (ciudad/estado/región) de la clave utilizada.
404Clave no válida (Wrong key) o recurso no encontrado.
409Ya existe un registro para esta combinación de identificador, año y semana.
500Error interno al procesar la solicitud.

Puntos finales públicos

GET/api/lastcountingpublicPúblico

Últimos recuentos publicados

Devuelve los últimos recuentos publicados por ubicación (ciudad, estado o país), con el número de huevos y datos de ovitrampas.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).
idintMuestra solo ocurrencias de la identificación dada. Ejemplo: id=7876.
datedateMuestra ocurrencias desde la fecha de inclusión. Ejemplo: date=2025-01-01.
date_collectdateMuestra ocurrencias desde la fecha de recolección en adelante. Ejemplo: date_collect=2024-12-12.
date_startdateFecha de inicio para filtrar los conteos. Ejemplo: date_start=2025-01-01.
date_enddateFecha de finalización para filtrar recuentos. Ejemplo: date_end=2025-12-31.

Nota: Si no se envían parámetros de ubicación, el punto final devuelve los recuentos más recientes de Brasil.

Ejemplo de solicitud

curl -G -d "municipality=Ponta%20Pora" \
  /es-py/api/lastcountingpublic

curl -G -d "state=MG" \
  /es-py/api/lastcountingpublic

Respuesta de muestra

[
  {
    "state_name": "Minas Gerais",
    "state_code": "MG",
    "municipality": "Ponta Pora",
    "municipality_code": "5006606",
    "eggs": 42,
    "week": 3,
    "year": 2025,
    "time": "2025-01-20 14:32:10",
    "counting_id": 118342,
    "ovitrap_website_id": 981,
    "ovitrap_id": "97",
    "latitude": -7.000000,
    "longitude": -8.000000,
    "date": "2025-01-20",
    "date_collect": "2025-01-27"
  }
]
GET/api/getmunicipalityblocksvisitpublicPúblico

Visitas en Cuartos

Devuelve datos sobre visitas (acciones de tratamiento) realizadas en bloques: una línea por visita, no por bloque.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Vista%20Alegre" \
  /es-py/api/getmunicipalityblocksvisitpublic

curl -G -d "state=MS" \
  /es-py/api/getmunicipalityblocksvisitpublic

Respuesta de muestra

[
  {
    "block_id": 4521,
    "block_actions_mean": 3.4,
    "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS",
    "action_land_total_total": 21,
    "action_land_residence_total": 10,
    "action_land_commercial_total": 5,
    "action_land_empty_total": 3,
    "action_land_strategy_total": 1,
    "action_land_another_total": 2,
    "action_address_district": "Centro",
    "action_address_sector": "Setor 04",
    "action_deposit_a1_quantity": 4,
    "action_deposit_a2_quantity": 2,
    "action_deposit_b_quantity": 5,
    "action_deposit_c_quantity": 1,
    "action_deposit_d1_quantity": 0,
    "action_deposit_d2_quantity": 3,
    "action_deposit_e_quantity": 0,
    "action_observation": "Foco encontrado em pneus nos fundos do imovel.",
    "latitude": -7.123456,
    "longitude": -34.845678
  }
]
GET/api/getmunicipalityblockspublic-2Público

Bloques registrados

Devuelve las manzanas registradas en el municipio, una línea por manzana, con el polígono, el total de propiedades por tipo y el número medio de acciones.

Nuevo punto final. Si buscas visitas realizadas por bloques, utiliza /api/getmunicipalityblocksvisitpublic. Al ser un endpoint público, la respuesta no incluye el agente responsable del bloqueo ni los identificadores de usuario/equipo.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Alta%20Floresta" \
  /es-py/api/getmunicipalityblockspublic-2

curl -G -d "state=MT" \
  /es-py/api/getmunicipalityblockspublic-2

Respuesta de muestra

[
  {
    "block_id": 118342,
    "block_group_id": "1",
    "block_datetime": "Mon, 09 Sep 2024 10:12:41 GMT",
    "latitude": -9.849042,
    "longitude": -56.065069,
    "block_coordinates": "[{\"lat\":-9.849042,\"lng\":-56.065069}, ...]",
    "block_address_district": "DISTRITO INDUSTRIAL",
    "block_address_sector": "DISTRITO INDUSTRIAL",
    "block_municipality_id": 5566,
    "block_active": 1,
    "block_actions_mean": 22,
    "block_land_total": 24,
    "block_land_residence": 18,
    "block_land_commercial": 4,
    "block_land_empty": 2,
    "block_land_strategy": 0,
    "block_land_another": 0,
    "municipality": "Alta Floresta",
    "municipality_code": "5100250",
    "state_name": "Mato Grosso",
    "state_code": "MT"
  }
]
GET/api/getmunicipalityedlspublicPúblico

EDL registradas

Devuelve datos de EDL (puntos estratégicos que reciben mantenimiento periódico por parte de los agentes) registrados por municipio.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Vista%20Alegre" \
  /es-py/api/getmunicipalityedlspublic

curl -G -d "state=MS" \
  /es-py/api/getmunicipalityedlspublic

Respuesta de muestra

[
  {
    "edl_id": 1832,
    "edl_group_id": "104",
    "edl_address_datetime": "2025-02-11 09:15:00",
    "edl_lat": -7.123456,
    "edl_lng": -34.845678,
    "edl_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "edl_responsable_agent": "João da Silva",
    "edl_block_group_id": "12",
    "edl_responsable_home": "Maria Souza",
    "edl_date": "2025-02-11",
    "edl_water_mean": 1.8,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityedlmaintenancepublicPúblico

mantenimiento EDL

Devuelve datos sobre el mantenimiento realizado en las EDL, incluida la observación registrada durante cada mantenimiento.

Reemplaza/api/getmunicipalityedlvisitspublic. Las EDL reciben mantenimiento, no visitas: los campos han pasado de edl_visit_* a edl_maintenance_*. La antigua URL sigue funcionando y sigue devolviendo los nombres antiguos, para no interrumpir las integraciones en producción, pero está descontinuada.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Vista%20Alegre" \
  /es-py/api/getmunicipalityedlmaintenancepublic

curl -G -d "state=MS" \
  /es-py/api/getmunicipalityedlmaintenancepublic

Respuesta de muestra

[
  {
    "edl_maintenance_id": 9021,
    "edl_id": 1832,
    "edl_maintenance_time_week": 7,
    "edl_maintenance_time_year": 2025,
    "edl_maintenance_datetime": "2025-02-11 09:20:00",
    "edl_maintenance_user_id": 348,
    "edl_maintenance_observation": "Sem foco encontrado no local.",
    "edl_maintenance_observation_id": 3,
    "edl_maintenance_water_level": 0.5,
    "edl_maintenance_lat": -7.123456,
    "edl_maintenance_lng": -34.845678,
    "edl_maintenance_municipality_id": 5007117,
    "edl_maintenance_region_id": 4,
    "edl_maintenance_state_id": 24,
    "edl_maintenance_country_id": 1,
    "edl_maintenance_date": "2025-02-11",
    "edl_maintenance_observation_name": "Sem foco",
    "edl_maintenance_observation_number": 3,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityovitrapspublicPúblico

Ovitrampas registradas

Devuelve datos de ovitrampas (puntos de seguimiento de huevos) registrados por municipio.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Vista%20Alegre" \
  /es-py/api/getmunicipalityovitrapspublic

curl -G -d "state=MS" \
  /es-py/api/getmunicipalityovitrapspublic

Respuesta de muestra

[
  {
    "ovitrap_id": 4471,
    "ovitrap_group_id": "97",
    "ovitrap_datetime": "2025-01-20 14:32:10",
    "ovitrap_lat": -7.123456,
    "ovitrap_lng": -34.845678,
    "ovitrap_lat_lng_error": 0,
    "ovitrap_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "ovitrap_eggs_mean": 12.5,
    "ovitrap_block_id": 4521,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityplacespublicPúblico

Puntos estratégicos (lugares)

Devuelve los puntos estratégicos (lugares de uso del suelo en riesgo de proliferación) registrados por municipio.

Parámetros

NombreTipoDescripción
statestringCódigo de estado. Ejemplo: state=RJ.
municipalitystringNombre del municipio. Ejemplo: municipality=Ponta Pora
countrystringNombre del país. Ejemplo: country=Brasil. Si se omite, se supone "Brasil".
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "municipality=Vista%20Alegre" \
  /es-py/api/getmunicipalityplacespublic

curl -G -d "state=MS" \
  /es-py/api/getmunicipalityplacespublic

Respuesta de muestra

[
  {
    "place_id": 771,
    "user_id": 348,
    "place_address_district": "Centro",
    "place_address_sector": "Setor 04",
    "place_datetime": "2025-02-05 10:00:00",
    "place_address_lat": -7.123456,
    "place_address_lng": -34.845678,
    "place_municipality_id": 5007117,
    "place_region_id": 4,
    "place_state_id": 24,
    "place_country_id": 1,
    "place_type_id": 2,
    "place_name": "Ferro-velho Bom Preço",
    "place_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "place_subtype": 5,
    "place_area": 320.5,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]

Puntos finales privados

Todos los puntos finales a continuación requieren el parámetro key con su clave API.

GET/api/lastcountingPrivado

Últimos recuentos publicados

Devuelve los últimos recuentos publicados dentro del alcance de la clave, con el número de huevos, los datos de la ovitrap y el usuario responsable.

Parámetros

NombreTipoDescripción
keystringSu clave API. Define el alcance de los recuentos devueltos.
pageintPágina de paginación (por defecto 1, máximo 100).
date_startdateFecha de inicio para filtrar los conteos. Ejemplo: date_start=2025-01-01.
date_enddateFecha de finalización para filtrar recuentos. Ejemplo: date_end=2025-12-31.

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/lastcounting

Respuesta de muestra

[
  {
    "state_name": "Minas Gerais",
    "state_code": "MG",
    "municipality": "Ponta Pora",
    "municipality_code": "5006606",
    "eggs": 42,
    "week": 3,
    "year": 2025,
    "time": "2025-01-20 14:32:10",
    "user": "Joao da Silva",
    "counting_id": 118342,
    "ovitrap_website_id": 981,
    "ovitrap_id": "97",
    "district": "Centro",
    "street": "Rua das Flores",
    "number": "123",
    "complement": "",
    "loc_inst": "",
    "sector": "Setor 04",
    "latitude": -7.000000,
    "longitude": -8.000000,
    "date": "2025-01-20",
    "date_collect": "2025-01-27"
  }
]
GET/api/getmunicipalityedlsPrivado

EDL registradas

Retorna os dados dos EDLs (pontos estratégicos visitados periodicamente pelos agentes) dentro do escopo geográfico da chave. O escopo é definido automaticamente pelo plano vinculado à chave — municipal, regional, estadual ou país — não sendo necessário informar município, estado ou país na requisição.

Parámetros

NombreTipoDescripción
keystringSua chave de API. Define o escopo geográfico dos EDLs retornados.
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/getmunicipalityedls

Respuesta de muestra

[
  {
    "edl_id": 1832,
    "edl_group_id": "104",
    "edl_address_datetime": "2025-02-11 09:15:00",
    "edl_lat": -7.123456,
    "edl_lng": -34.845678,
    "edl_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "edl_responsable_agent": "João da Silva",
    "edl_block_group_id": "12",
    "edl_responsable_home": "Maria Souza",
    "edl_date": "2025-02-11",
    "edl_water_mean": 1.8,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityedlvisitsPrivado

Visitas de EDLs

Retorna os dados das visitas realizadas aos EDLs dentro do escopo geográfico da chave, incluindo a observação registrada em cada visita. O escopo é definido automaticamente pelo plano vinculado à chave — municipal, regional, estadual ou país — não sendo necessário informar município, estado ou país na requisição.

Parámetros

NombreTipoDescripción
keystringSua chave de API. Define o escopo geográfico das visitas retornadas.
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/getmunicipalityedlvisits

Respuesta de muestra

[
  {
    "edl_visit_id": 9021,
    "edl_id": 1832,
    "edl_visit_time_week": 7,
    "edl_visit_time_year": 2025,
    "edl_visit_datetime": "2025-02-11 09:20:00",
    "edl_visit_user_id": 348,
    "edl_visit_observation": "Sem foco encontrado no local.",
    "edl_visit_observation_id": 3,
    "edl_visit_water_level": 0.5,
    "edl_visit_lat": -7.123456,
    "edl_visit_lng": -34.845678,
    "edl_visit_municipality_id": 5007117,
    "edl_visit_region_id": 4,
    "edl_visit_state_id": 24,
    "edl_visit_country_id": 1,
    "edl_visit_date": "2025-02-11",
    "edl_visit_observation_name": "Sem foco",
    "edl_visit_observation_number": 3,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityblocksPrivado

Últimas acciones en bloques

Retorna os dados das ações (visitas de tratamento) realizadas em quarteirões dentro do escopo geográfico da chave. O escopo é definido automaticamente pelo plano vinculado à chave — municipal, regional, estadual ou país — não sendo necessário informar município, estado ou país na requisição.

Parámetros

NombreTipoDescripción
keystringSua chave de API. Define o escopo geográfico das ações retornadas.
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/getmunicipalityblocks

Respuesta de muestra

[
  {
    "block_id": 4521,
    "block_actions_mean": 3.4,
    "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS",
    "action_land_total_total": 21,
    "action_land_residence_total": 10,
    "action_land_commercial_total": 5,
    "action_land_empty_total": 3,
    "action_land_strategy_total": 1,
    "action_land_another_total": 2,
    "action_address_district": "Centro",
    "action_address_sector": "Setor 04",
    "action_deposit_a1_quantity": 4,
    "action_deposit_a2_quantity": 2,
    "action_deposit_b_quantity": 5,
    "action_deposit_c_quantity": 1,
    "action_deposit_d1_quantity": 0,
    "action_deposit_d2_quantity": 3,
    "action_deposit_e_quantity": 0,
    "action_observation": "Foco encontrado em pneus nos fundos do imovel.",
    "latitude": -7.123456,
    "longitude": -34.845678
  }
]
GET/api/getmunicipalityovitrapsPrivado

Ovitrampas registradas

Retorna os dados das ovitrampas (pontos de monitoramento de ovos) dentro do escopo geográfico da chave. O escopo é definido automaticamente pelo plano vinculado à chave — municipal, regional, estadual ou país — não sendo necessário informar município, estado ou país na requisição.

Parámetros

NombreTipoDescripción
keystringSua chave de API. Define o escopo geográfico das ovitrampas retornadas.
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/getmunicipalityovitraps

Respuesta de muestra

[
  {
    "ovitrap_id": 4471,
    "ovitrap_group_id": "97",
    "ovitrap_datetime": "2025-01-20 14:32:10",
    "ovitrap_lat": -7.123456,
    "ovitrap_lng": -34.845678,
    "ovitrap_lat_lng_error": 0,
    "ovitrap_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "ovitrap_eggs_mean": 12.5,
    "ovitrap_block_id": 4521,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityplacesPrivado

Puntos estratégicos (lugares)

Retorna os pontos estratégicos (locais de uso do solo com risco de proliferação) dentro do escopo geográfico da chave. O escopo é definido automaticamente pelo plano vinculado à chave — municipal, regional, estadual ou país — não sendo necessário informar município, estado ou país na requisição.

Parámetros

NombreTipoDescripción
keystringSua chave de API. Define o escopo geográfico dos pontos retornados.
pageintPágina de paginación (por defecto 1, máximo 100).

Ejemplo de solicitud

curl -G -d "key=KEY&page=1" \
  /es-py/api/getmunicipalityplaces

Respuesta de muestra

[
  {
    "place_id": 771,
    "user_id": 348,
    "place_address_district": "Centro",
    "place_address_sector": "Setor 04",
    "place_datetime": "2025-02-05 10:00:00",
    "place_address_lat": -7.123456,
    "place_address_lng": -34.845678,
    "place_municipality_id": 5007117,
    "place_region_id": 4,
    "place_state_id": 24,
    "place_country_id": 1,
    "place_type_id": 2,
    "place_name": "Ferro-velho Bom Preço",
    "place_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "place_subtype": 5,
    "place_area": 320.5,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
POST/api/postcountingPrivado

Leer envío

Envía la lectura de una ovitrampa. Es posible enviar datos a una ovitrampa existente o enviar los datos e instalar una nueva ovitrampa al mismo tiempo.

Parámetros

NombreTipoDescripción
keystringSu clave API. Define el alcance del envío.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postcounting?key=KEY"

Para envío estándar, donde no es necesario instalar una ovitrampa nueva, envíe los siguientes campos (todo obligatorio) en el cuerpo de la solicitud (form):

{
  "ovitrap_group_id": 97,
  "ovitrap_lat": -7.000000,
  "ovitrap_lng": -8.000000,
  "date": "2025-01-20",
  "counting_observation_id": 1,
  "counting_observation": "caso o counting_observation_id seja 9",
  "counting_eggs": 5
}

Tabla con los ID de cada tipo de observación (counting_observation_id):

IDSignificado
1Sin observaciones
2Intervalo entre instalación y recogida más largo de lo esperado
3Ovitrap o paleta faltante
4Ovitrap o paleta rota
5Ovitrap o paleta retirada
6Ovitrampa seca
7casa cerrada
8Ovitrampa llena de agua
9Ovitrampa con poca agua
10Otra observación

Para instalar una nueva ovitrampa junto al envío, obligatorio los campos: ovitrap_lat, ovitrap_lng, ovitrap_group_id

{
  "ovitrap_group_id": 96,
  "ovitrap_address_district": "Distrito",
  "ovitrap_address_street": "Rua",
  "ovitrap_address_number": "Numero",
  "ovitrap_address_complement": "Complemento",
  "ovitrap_address_loc_inst": "",
  "ovitrap_lat": -7.000000,
  "ovitrap_lng": -8.000000,
  "ovitrap_address_sector": "Setor",
  "ovitrap_responsable": "Responsavel",
  "ovitrap_block_id": "Quarteirao",
  "ovitrap_type_id": 1,
  "date": "2025-01-20",
  "counting_date_collect": "2025-01-27",
  "counting_observation_id": 1,
  "counting_observation": "caso o counting_observation_id seja 9",
  "counting_eggs": 5
}

Tabla con los ID de cada tipo de ovitrampa (ovitrap_type_id): enviar 1 a ovitrampa urbana y 2 a ovitrampa rural. El campo es opcional y, al no enviarse, la ovitrampa se instala como urbana:

IDSignificado
1Ovitrampa urbana (estándar)
2Ovitrampa rural
Respuestas específicas:
  • 400 — cuando no se envía alguno de los campos obligatorios: ovitrap_lat, ovitrap_lng, ovitrap_group_id
  • 400 — cuando el ovitrap_type_id enviado no es ni 1 ni 2.
  • 404 — Ya hay un recuento para esta ovitrampa, año y semana.
POST/api/postdeletecountingPrivado

Eliminar lectura

Elimina la lectura de una ovitrampa.

Parámetros

NombreTipoDescripción
keystringSu clave API. Define el alcance de la eliminación.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postdeletecounting?key=KEY"

Datos requeridos en el cuerpo de la solicitud (form):

{
  "ovitrap_group_id": 97,
  "date": "2025-01-20"
}
POST/api/postdeleteovitrapPrivado

Eliminar ovitrap

Retire una ovitrampa.

Parámetros

NombreTipoDescripción
keystringSu clave API.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postdeleteovitrap?key=KEY"

Datos requeridos en el cuerpo de la solicitud (form):

{
  "ovitrap_group_id": 97
}
POST/api/postactionPrivado

Insertar visita

Registrar una visita/acción en un bloque. Para agregar la visita a un bloque existente, envíe el campo block_id. Si no existe, utilice block_group_id — el sistema creará el bloque automáticamente. Este punto final solo permite la inserción de manzanas que se encuentren dentro del municipio del solicitante.

Parámetros

NombreTipoDescripción
keystringSu clave API.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postaction?key=KEY"

Datos enviados en form o parámetros de consulta, utilizando block_id:

{
  "block_id": 97,
  "date": "2025-01-20",
  "block_land_residence": 10,
  "action_land_residence_out": 2,
  "action_land_residence_breedings": 1,
  "action_land_residence_treated": 1,

  "block_land_commercial": 5,
  "action_land_commercial_out": 0,
  "action_land_commercial_breedings": 0,
  "action_land_commercial_treated": 0,

  "block_land_empty": 3,
  "action_land_empty_out": 1,
  "action_land_empty_breedings": 2,
  "action_land_empty_treated": 1,

  "block_land_strategy": 1,
  "action_land_strategy_out": 0,
  "action_land_strategy_breedings": 0,
  "action_land_strategy_treated": 0,

  "block_land_special": 0,
  "action_land_special_out": 0,
  "action_land_special_breedings": 0,
  "action_land_special_treated": 0,

  "block_land_another": 2,
  "action_land_another_out": 0,
  "action_land_another_breedings": 0,
  "action_land_another_treated": 0,

  "action_deposit_a1_quantity": 4,
  "action_deposit_a1_eliminated": 2,
  "action_deposit_a1_treated": 1,
  "action_deposit_a1_larvicid": 10,

  "action_deposit_a2_quantity": 2,
  "action_deposit_a2_eliminated": 1,
  "action_deposit_a2_treated": 0,
  "action_deposit_a2_larvicid": 0,

  "action_deposit_b_quantity": 5,
  "action_deposit_b_eliminated": 5,
  "action_deposit_b_treated": 0,
  "action_deposit_b_larvicid": 0,

  "action_deposit_c_quantity": 1,
  "action_deposit_c_eliminated": 0,
  "action_deposit_c_treated": 1,
  "action_deposit_c_larvicid": 5,

  "action_deposit_d1_quantity": 0,
  "action_deposit_d1_eliminated": 0,
  "action_deposit_d1_treated": 0,
  "action_deposit_d1_larvicid": 0,

  "action_deposit_d2_quantity": 3,
  "action_deposit_d2_eliminated": 1,
  "action_deposit_d2_treated": 2,
  "action_deposit_d2_larvicid": 15,

  "action_deposit_e_quantity": 0,
  "action_deposit_e_eliminated": 0,
  "action_deposit_e_treated": 0,
  "action_deposit_e_larvicid": 0,

  "action_observation": "Visita realizada conforme cronograma. Foco encontrado em pneus nos fundos do imovel."
}

Optando por block_group_id (bloque aún no registrado), envía también los datos del propio bloque:

{
  "block_group_id": 97,
  "date": "2025-01-20",
  "block_address_district": "Centro Historico",
  "block_address_sector": "Setor 04 - Norte",
  "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
  "block_lat": -7.123456,
  "block_lng": -34.845678,
  "block_responsable": "Joao da Silva",

  "block_land_residence": 10,
  "action_land_residence_out": 2,
  "action_land_residence_breedings": 1,
  "action_land_residence_treated": 1,

  "block_land_commercial": 5,
  "action_land_commercial_out": 0,
  "action_land_commercial_breedings": 0,
  "action_land_commercial_treated": 0,

  "block_land_empty": 3,
  "action_land_empty_out": 1,
  "action_land_empty_breedings": 2,
  "action_land_empty_treated": 1,

  "block_land_strategy": 1,
  "action_land_strategy_out": 0,
  "action_land_strategy_breedings": 0,
  "action_land_strategy_treated": 0,

  "block_land_special": 0,
  "action_land_special_out": 0,
  "action_land_special_breedings": 0,
  "action_land_special_treated": 0,

  "block_land_another": 2,
  "action_land_another_out": 0,
  "action_land_another_breedings": 0,
  "action_land_another_treated": 0,

  "action_deposit_a1_quantity": 4,
  "action_deposit_a1_eliminated": 2,
  "action_deposit_a1_treated": 1,
  "action_deposit_a1_larvicid": 10,

  "action_deposit_a2_quantity": 2,
  "action_deposit_a2_eliminated": 1,
  "action_deposit_a2_treated": 0,
  "action_deposit_a2_larvicid": 0,

  "action_deposit_b_quantity": 5,
  "action_deposit_b_eliminated": 5,
  "action_deposit_b_treated": 0,
  "action_deposit_b_larvicid": 0,

  "action_deposit_c_quantity": 1,
  "action_deposit_c_eliminated": 0,
  "action_deposit_c_treated": 1,
  "action_deposit_c_larvicid": 5,

  "action_deposit_d1_quantity": 0,
  "action_deposit_d1_eliminated": 0,
  "action_deposit_d1_treated": 0,
  "action_deposit_d1_larvicid": 0,

  "action_deposit_d2_quantity": 3,
  "action_deposit_d2_eliminated": 1,
  "action_deposit_d2_treated": 2,
  "action_deposit_d2_larvicid": 15,

  "action_deposit_e_quantity": 0,
  "action_deposit_e_eliminated": 0,
  "action_deposit_e_treated": 0,
  "action_deposit_e_larvicid": 0,

  "action_observation": "Area com alta densidade de recipientes descartaveis."
}
Respuestas específicas:
  • 400 — cuando date no se envía o cuando uno de los campos numéricos no es un número válido.
  • 400 — cuando block_group_id no se envía al crear un nuevo bloque.
  • 403 — cuando el block_id informado no pertenece al municipio clave.
  • 409 — cuando ya hay visita para ese bloque, año y semana.
POST/api/postdeleteactionPrivado

Eliminar visita

Elimina una visita de un bloque.

Parámetros

NombreTipoDescripción
keystringSu clave API.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postdeleteaction?key=KEY"

Datos requeridos en el cuerpo de la solicitud (form):

{
  "block_group_id": 97,
  "date": "2025-01-20"
}
POST/api/postdeleteblockPrivado

Eliminar bloque

Elimina un bloque.

Parámetros

NombreTipoDescripción
keystringSu clave API.

Ejemplo de solicitud

curl -X POST \
  "/es-py/api/postdeleteblock?key=KEY"

Datos requeridos en el cuerpo de la solicitud (form):

{
  "block_group_id": 97
}