Notas da versão

Versão 4.0

As seguintes atualizações e novos recursos estão incluídos nas APIs de Navegação segura (v4).

API Lookup (v4)

O que é igual:

  • A API ainda tem clientes que consultam diretamente o servidor e as listas da Navegação segura do Google.

O que é diferente:

  • O método HTTP GET não tem mais suporte. Use o método HTTP POST.
  • O parâmetro key agora é o único parâmetro obrigatório no URL de solicitação HTTP POST.
  • O formato de solicitação e resposta HTTP POST foi alterado. Não é mais possível usar texto simples. Em vez disso, use JSON.

API Update (v4)

O que é igual:

  • Os clientes da API ainda atualizam periodicamente os prefixos de hash SHA256 nas listas do banco de dados local.
  • A API também tem uma solicitação semelhante para recuperar os hashes SHA256 completos quando um cliente encontra uma colisão de prefixos de hash.

O que é diferente:

  • O parâmetro key agora é o único parâmetro obrigatório no URL de solicitação HTTP POST.
  • O formato de solicitação e resposta HTTP POST foi alterado. Não é mais possível usar texto simples. Em vez disso, use JSON.
  • O modo como as atualizações são codificadas mudou. Em vez de exibir blocos de adição e subpartes, a API agora exibe diferenças usando um protocolo de controle de versão simples. O cliente envia o estado atual dele ao servidor com as atualizações solicitadas. O servidor responde com um novo estado do cliente e uma diferença para que o cliente seja totalmente atualizado.
  • Para garantir o mínimo de proteção ao acomodar as restrições do cliente, a API exibe listas priorizadas de ameaças. Recursos do dispositivo, largura de banda, geolocalização e outros sinais são usados para veicular os dados de ameaças de maior prioridade para cada cliente.

Método threatLists.list

Um novo método, threatLists.list, retorna uma lista das listas da Navegação segura atualmente disponíveis para pesquisa ou download.

Códigos de status

Os códigos de status HTTP gerados pelo servidor em resposta a uma solicitação HTTP POST foram alterados.