Politica di compatibilità
L'API non dispone del controllo delle versioni dell'URL. Seguiamo invece tre regole affinché le integrazioni già in produzione non smettano di funzionare senza preavviso:
- Il nuovo comportamento ottiene un nuovo URL. Quando il formato dei dati cambia, il vecchio endpoint continua a rispondere esattamente come prima e la modifica avviene nella direzione opposta.
- I campi possono essere aggiunti in qualsiasi momento. Tratta la risposta come un oggetto aperto: ignora ciò che non sai piuttosto che romperlo.
- Gli endpoint fuori produzione rimangono online. Lasciano il riferimento, ma continuano a rispondere: l'elenco seguente mostra la sostituzione per ciascuno.
Hai domande su eventuali modifiche o hai bisogno di una scadenza per la migrazione? Scrivi a contaovosdengue@gmail.com.
Endpoint fuori produzione
Continuano tutti a funzionare e restituiscono esattamente lo stesso contenuto di prima. Semplicemente non ricevono nuovi campi.
| Punto finale | Utilizzare sul posto | Motivo |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | Il nome diceva isolati, ma il ritorno veniva sempre dalle visite a essi. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | Gli EDL ricevono manutenzione, non visite; i campi andarono da edl_visit_* A edl_maintenance_*. |
Cambia la cronologia
2026-09-11
Datas e coordenadas impossíveis passam a ser recusadas
Cambiamento di comportamento
- Toda data de registro (instalação e coleta da leitura, visita, manutenção e instalação de EDL) precisa estar entre 01/01/1900 e hoje. Antes, a data de coleta só tinha o formato conferido, e um ano digitado com três dígitos, como
0202-08-14, era gravado. Carga retroativa de qualquer ano a partir de 1900 continua aceita. - Latitude ou longitude exatamente zero passam a ser recusadas em todos os endpoints: é posição que não foi registrada, não um lugar.
- A resposta é
400 com a frase dizendo qual campo e por quê, por exemplo "Data de coleta: 0202-08-14 é anterior a 01/01/1900 — confira o ano."
Quem já manda datas e coordenadas reais não precisa mudar nada. Um envio que antes era aceito com data impossível ou coordenada zerada passa a receber 400 em vez de 200.
2026-09-11
Edição de registros, chave no cabeçalho e correções
Notizia
- Novos
/api/posteditovitrap, /api/posteditcounting, /api/posteditblock, /api/posteditaction, /api/posteditedl, /api/posteditedlmaintenance e /api/posteditplace — editam registros existentes, com edição parcial, troca de código ou data e cópia opcional do endereço novo para as leituras antigas (atualizar_desde). - A chave pode ir no cabeçalho
Authorization: Bearer SUA_CHAVE, em todos os endpoints. O ?key= continua aceito. /api/postdeleteaction respondia erro 500 em toda chamada que achava o quarteirão; agora apaga a visita, inclusive as criadas pela própria API./api/postcounting: quando a coordenada da ovitrampa muda, os campos de endereço que não vieram no pedido passam a ser mantidos. Antes eram apagados.- Apagar uma leitura, visita ou manutenção pela API passou a recalcular a média do registro (ovos da ovitrampa, visitas do quarteirão, água da EDL).
Nenhuma integração existente precisa mudar. A única diferença visível para quem já integrou é a do /api/postcounting: um endereço que antes era apagado agora é mantido.
2026-08-01
Nomi corretti per isolati e manutenzione EDL
NotiziaInterruzione
- Nuovo
/api/getmunicipalityblocksvisitpublic — visite effettuate in isolati, con un record per visita. Stesso contenuto del vecchio /api/getmunicipalityblockspublic, ora con il nome giusto. - Nuovo
/api/getmunicipalityblockspublic-2 — gli isolati stessi, un record per isolato, con poligono, immobili totali per tipologia e quote medie. - Nuovo
/api/getmunicipalityedlmaintenancepublic — Manutenzione EDL, con i campi rinominati da edl_visit_* A edl_maintenance_*. - Interrotto
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — sono ancora in onda, con lo stesso feedback di sempre.
Non è necessario modificare le integrazioni esistenti. La migrazione è consigliata solo a coloro che desiderano i nomi dei campi corretti o l'isolato dei dati separati dalle visite.
2026-07-30
Ovitrappola rurale e correzione della settimana epidemiologica
Notizia
/api/postcounting cominciò ad accettare ovitrap_type_id quando si installa un ovitrappola: 1 per urbano (standard, quando il campo non viene inviato) e 2 per rurale. Qualsiasi altro valore ritorna 400 "Tipo de ovitrampa inválido".- Validazione della settimana epidemiologica del
/api/postcounting e /api/postaction ho iniziato a confrontare anno e settimana insieme. In precedenza, una data di un anno futuro con un numero basso di settimane poteva essere accettata erroneamente.
2026-07-28
Nuovi endpoint pubblici per EDL, ovitraps e punti strategici
Notizia
/api/getmunicipalityedlspublic — EDL registrati per comune./api/getmunicipalityovitrapspublic — ovitrappole registrate, con coordinate e numero medio di uova./api/getmunicipalityplacespublic — punti strategici, con tipologia, sottotipo e zona.- Tutti accettano
country, state, municipality e page, come altri endpoint pubblici.
2026-04-23
Invio delle visite in isolati
Notizia
- Nuovo
/api/postaction — registra una visita con gli immobili intervenuti ed i depositi rinvenuti per classe (a1, a2, b, c, d1, d2, e). - Invio
block_group_id invece di block_id, l'isolato viene creato automaticamente all'interno del comune chiave. - Risposte specifiche:
403 quando l'isolato è di un altro comune e 409 quando c'è già una visita per quel isolato, anno e settimana.
2026-03-27
La chiave viene ora letta dall'URL
Cambiamento di comportamento
Su tutti gli endpoint privati, il key ha iniziato a essere letto esclusivamente dalla stringa di query (?key=SUA_CHAVE), incluso nel POST. Le integrazioni che hanno inviato solo la chiave nel corpo del modulo iniziano a ricevere 404 "Wrong key" — basta spostare la chiave sull'URL, mantenendo gli altri campi nel corpo.
2026-02-24
Rimozione di visite e isolati
Notizia
/api/postdeleteaction — rimuove la visita da un isolato, identificato da block_group_id e date./api/postdeleteblock — rimuovere l'isolato.
2026-02-04
Filtra per periodo nei conteggi privati
Notizia
/api/lastcounting cominciò ad accettare date_start e date_end, permettendoti di ridurre i conteggi in base all'intervallo di date invece di scorrere ogni pagina.
2025-10-19
Sincronizzazione incrementale sui conteggi pubblici
Notizia
/api/lastcountingpublic cominciò ad accettare id (solo le occorrenze di quell'identificatore), date (data di inclusione) e date_collect (data de coleta). Questi filtri ti consentono di mantenere una base con mirroring senza eseguire il downgrade dell'intera cronologia.
2025-03-18
Filtra per periodo nei conteggi pubblici
Notizia
/api/lastcountingpublic cominciò ad accettare date_start e date_end.
2025-03-06
Rimozione di ovitrap
Notizia
/api/postdeleteovitrap — rimuove un ovitrap dal ovitrap_group_id, nel comune di Chave.