O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Guias de migração: um novo espaço para quem está trocando de provedor
Saber que existe um host compatível é uma coisa. Saber exatamente como mover uma integração existente para ele, sem quebrar nada no caminho, é outra. Criamos um conjunto dedicado de guias de migração para fechar essa lacuna, reunidos em /docs/compatibility/.
Os guias percorrem as etapas práticas da troca: o que muda em uma requisição, o que continua igual, qual método de autenticação usar e o que observar na resposta, provedor por provedor, endpoint por endpoint. Como cada um dos nossos dezessete hosts compatíveis reproduz exatamente o formato de requisição e resposta do provedor original, com exceção dos textos de copyright, termos e privacidade, os guias se concentram principalmente nas partes que realmente diferem: o nome do host para onde apontar, a chave a gerar e os cabeçalhos de cota que agora acompanham cada resposta.
Escrevemos esses guias pensando em um leitor específico: alguém que já tem código funcionando com outro provedor e quer confiança, e não apenas uma promessa, de que apontá-lo para nós vai continuar funcionando. Isso significa ser explícito também sobre os preços durante a transição. Todos os endpoints e todos os hosts compatíveis custam o mesmo, com 2.500 requisições gratuitas por dia a partir de qualquer endereço e mais 2.500 requisições gratuitas por dia por chave, então testar uma migração não custa nada antes de você se comprometer com ela.
Cada guia também cobre os pequenos detalhes que costumam atrapalhar uma migração se forem deixados de lado: como as requisições em lote são contadas, já que uma chamada em massa conta cada item individualmente, e não a chamada como um todo, e o que significam os cabeçalhos de cota extras em cada resposta, caso você ainda não os conheça. Nada disso exige adivinhação quando o guia certo está aberto ao lado do seu código.
Para uma equipe que está avaliando a mudança, o caminho recomendado é simples: leia o guia do provedor que você usa atualmente, gere uma chave e teste algumas requisições reais no host compatível antes de mexer em qualquer código de produção. Como a cota gratuita cobre esses testes por completo, não há custo em comparar os dois lado a lado antes de decidir.
A lista completa dos hosts compatíveis cobertos por esses guias está em /compatibility/, e a documentação geral de autenticação e de limite de taxa que se aplica a todos eles está em /docs/authentication/ e /docs/rate-limits/. Pretendemos continuar ampliando esta coleção de guias à medida que a cobertura de compatibilidade crescer.