Примечания к выпуску

Версия 4.0

Следующие обновления и новые функции включены в API безопасного просмотра (v4).

API поиска (v4)

Что то же самое:

• Клиенты API по-прежнему напрямую запрашивают сервер Google Safe Browsing и списки безопасного просмотра.

Что отличается:

• Метод HTTP GET больше не поддерживается. Вместо этого используйте метод HTTP POST .
• key параметр теперь является единственным параметром, необходимым в URL-адресе запроса HTTP POST .
• Формат запроса и ответа HTTP POST изменился. Обычный текст больше не поддерживается. Вместо этого используйте JSON.

Обновление API (v4)

Что то же самое:

• API по-прежнему заставляет клиентов периодически обновлять хэш-префиксы SHA256 в списках локальной базы данных.
• API также имеет аналогичный запрос на получение полноразмерных хэшей SHA256, когда клиент сталкивается с конфликтом хэш-префиксов.

Что отличается:

• key параметр теперь является единственным параметром, необходимым в URL-адресе запроса HTTP POST .
• Формат запроса и ответа HTTP POST изменился. Обычный текст больше не поддерживается. Вместо этого используйте JSON.
• Способ кодирования обновлений изменился. Вместо обслуживания дополнительных и дополнительных фрагментов API теперь обслуживает различия, используя простой протокол управления версиями. Клиент отправляет на сервер свое текущее состояние вместе с запрошенными обновлениями. Сервер отвечает новым состоянием клиента и дифференциалом, чтобы полностью обновить клиент.
• Чтобы обеспечить минимальную потерю защиты при учете ограничений клиента, API предоставляет списки приоритетных угроз. Ресурсы устройства, пропускная способность, геолокация и другие сигналы используются для передачи данных об угрозах с наивысшим приоритетом каждому клиенту.

ThreatLists.list Метод

Новый метод threatLists.list возвращает список списков безопасного просмотра, доступных в настоящее время для поиска или загрузки.

Коды состояния

Коды состояния HTTP, генерируемые сервером в ответ на запрос HTTP POST , изменились.