호환성 정책
API에는 URL 버전 관리가 없습니다. 대신, 우리는 이미 프로덕션에 있는 통합이 경고 없이 작동을 멈추지 않도록 세 가지 규칙을 따릅니다.
- 새로운 행동은 새로운 URL을 얻습니다. 데이터 형식이 변경되면 이전 엔드포인트는 계속해서 이전과 똑같이 응답하고 변경 사항은 반대 방향으로 진행됩니다.
- 필드는 언제든지 추가할 수 있습니다. 답을 열린 개체로 취급하십시오. 모르는 것을 깨기보다는 무시하십시오.
- 중단된 엔드포인트는 온라인 상태로 유지됩니다. 그들은 참조를 남기지만 계속 응답합니다. 아래 목록은 각 참조에 대한 대체 항목을 보여줍니다.
변경 사항에 대해 질문이 있거나 마이그레이션 마감일이 필요합니까? 에 쓰기 contaovosdengue@gmail.com.
중단된 엔드포인트
모두 계속 작동하며 이전과 정확히 동일한 콘텐츠를 반환합니다. 단지 새로운 필드를 받지 못할 뿐입니다.
| 엔드포인트 | 제자리에서 사용 | 이유 |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | 이름에는 블록이라고 적혀 있지만 항상 방문을 통해 돌아왔습니다. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | EDL은 방문이 아닌 유지 관리를 받습니다. 들판은에서 갔다 edl_visit_* 에게 edl_maintenance_*. |
변경 내역
2026-09-11
Datas e coordenadas impossíveis passam a ser recusadas
행동 변화
- 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
소식
- 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
블록 및 EDL 유지 관리의 올바른 이름
소식정지
- 새로운
/api/getmunicipalityblocksvisitpublic — 방문당 하나의 기록을 가지고 블록 단위로 수행되는 방문입니다. 기존 내용과 동일 /api/getmunicipalityblockspublic, 이제 올바른 이름으로. - 새로운
/api/getmunicipalityblockspublic-2 — 블록 자체, 블록당 하나의 레코드, 다각형 포함, 유형별 총 속성 및 평균 공유. - 새로운
/api/getmunicipalityedlmaintenancepublic — EDL 유지 관리(필드 이름이 다음에서 변경됨) edl_visit_* 에게 edl_maintenance_*. - 단종
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — 항상 같은 피드백을 받으며 여전히 방송 중입니다.
기존 통합을 변경할 필요가 없습니다. 정확한 필드 이름이나 방문과 분리된 블록 데이터를 원하는 경우에만 마이그레이션을 권장합니다.
2026-07-30
농촌 수란관 및 역학 주간 교정
소식
/api/postcounting 받아들이기 시작했다 ovitrap_type_id 수란 트랩 설치시 : 도시용 1 개 (표준, 밭이 보내지지 않는 경우), 농촌 용 2 개. 다른 값은 반환됩니다. 400 "Tipo de ovitrampa inválido".- 역학 주간 검증
/api/postcounting e /api/postaction 연도와 주를 함께 비교하기 시작했습니다. 이전에는 주 수가 적은 미래 연도의 날짜가 잘못 승인될 수 있었습니다.
2026-07-28
EDL, 난관 트랩 및 전략적 지점을 위한 새로운 공개 엔드포인트
소식
/api/getmunicipalityedlspublic — 지방자치단체별로 등록된 EDL입니다./api/getmunicipalityovitrapspublic — 좌표와 평균 알 수를 포함한 등록된 난포집./api/getmunicipalityplacespublic — 유형, 하위 유형 및 영역이 포함된 전략적 포인트입니다.- 모두가 받아들인다
country, state, municipality e page, 다른 공개 엔드포인트와 같습니다.
2026-04-23
블록 단위로 방문 보내기
소식
- 새로운
/api/postaction — 작업한 부동산 방문과 수업별 발견된 보증금을 기록합니다. (a1, a2, b, c, d1, d2, e). - 배상
block_group_id 대신에 block_id, 블록은 주요 자치단체 내에서 자동으로 생성됩니다. - 구체적인 답변:
403 블록이 다른 자치단체에서 온 경우 409 해당 블록, 연도, 주에 대한 방문이 이미 있는 경우.
2026-03-27
이제 URL에서 키를 읽습니다.
행동 변화
모든 개인 끝점에서 key 쿼리 문자열에서만 읽기 시작했습니다. (?key=SUA_CHAVE), POST를 포함합니다. 양식 본문의 키만 보낸 통합이 수신을 시작합니다. 404 "Wrong key" — 본문의 다른 필드를 유지하면서 키를 URL로 이동하면 됩니다.
2026-02-24
방문 및 차단 제거
소식
/api/postdeleteaction — 다음으로 식별되는 블록에서 방문을 제거합니다. block_group_id e date./api/postdeleteblock — 블록을 제거하십시오.
2026-02-04
비공개 개수에서 기간별로 필터링
소식
/api/lastcounting 받아들이기 시작했다 date_start e date_end, 모든 페이지를 스크롤하는 대신 날짜 범위별로 개수를 줄일 수 있습니다.
2025-10-19
공개 개수에 대한 증분 동기화
소식
/api/lastcountingpublic 받아들이기 시작했다 id (해당 식별자에서만 발생), date (포함 날짜) e date_collect (data de coleta). 이 필터를 사용하면 전체 기록을 다운그레이드하지 않고도 미러링된 기반을 유지할 수 있습니다.
2025-03-18
공개 횟수에서 기간별로 필터링
소식
/api/lastcountingpublic 받아들이기 시작했다 date_start e date_end.
2025-03-06
수란 트랩 제거
소식
/api/postdeleteovitrap — 에서 난관을 제거합니다. ovitrap_group_id, Chave 지방자치단체 내.