Политика совместимости
В API нет управления версиями URL. Вместо этого мы следуем трем правилам, чтобы уже находящиеся в производстве интеграции не переставали работать без предупреждения:
- Новое поведение получает новый URL. Когда формат данных изменяется, старая конечная точка продолжает реагировать точно так же, как и раньше, и изменение происходит в другую сторону.
- Поля можно добавлять в любое время. Относитесь к ответу как к открытому объекту: игнорируйте то, чего вы не знаете, вместо того, чтобы сломать его.
- Прекращенные конечные точки остаются в сети. Ссылку оставляют, но продолжают отвечать — в списке ниже указана замена для каждого.
У вас есть вопросы по поводу каких-либо изменений или вам нужен крайний срок для миграции? Напишите в contaovosdengue@gmail.com.
Конечные точки, выпуск которых прекращен
Все они продолжают работать и возвращают точно такой же контент, как и раньше. Они просто не получают новых полей.
| Конечная точка | Использовать на месте | Причина |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | В названии говорилось, что кварталы, но отдача от посещения их всегда была. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | EDL получают обслуживание, а не посещения; поля пошли от edl_visit_* к edl_maintenance_*. |
История изменений
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, в муниципалитете Чаве.