O que dados de localização "em tempo real" realmente exigem
"Tempo real" é usado como sinônimo de rápido. O que deveria significar é que a resposta reflete o estado atual do mundo, e não um retrato do trimestre passado.
Tag
#design-de-api
Como tratamos resultados nulos e de baixa confiança
Quando uma consulta realmente não pode ser resolvida de forma confiável, não retornar nada é uma resposta melhor do que retornar um palpite disfarçado de fato. Veja o raciocínio por trás dessa escolha.
Por que os dados de altitude são tratados como algo secundário
Os dados de altitude raramente ganham uma linha própria em uma página de preços, e essa ausência diz algo real sobre a seriedade com que eles são construídos.
Contra cobrar a mais por métodos básicos de autenticação
Um cabeçalho, um bearer token e um parâmetro de consulta autenticam uma requisição da mesma forma. Cobrar mais por um deles é cobrar por uma preferência, não por um recurso.
Diferenças de limite de taxa a esperar ao trocar de provedor
Os limites de taxa variam de estrutura entre provedores, não apenas de número. Veja o que conferir antes de supor que a sua lógica atual continua valendo.
Por que preferimos responder com um erro a dar um palpite errado
Uma resposta errada que parece confiante é pior do que uma falha honesta. Um erro diz para você verificar algo. Um palpite errado e confiante diz que está tudo certo.
Como migrar uma integração no servidor sem mexer no cliente
Uma migração de geocodificação no servidor muitas vezes pode ser invisível para as aplicações cliente que dependem dela. Veja como planejá-la dessa forma.
Por que faixas de preço por país são uma má ideia
Cobrar mais para consultar um endereço em um país do que em outro trata a própria geografia como alavanca de preço, em vez de dados simples e comuns a serem servidos.
Por que as consultas de código postal merecem ser tratadas como prioridade
Um endpoint de código postal precificado e documentado como algo secundário também será construído como algo secundário. Levá-lo a sério começa por tratá-lo em pé de igualdade.
O que o setor ainda erra na adoção do IPv6
Uma API de consulta de IP que ainda trata o IPv6 como um caso extremo menor está, discretamente, tratando uma parcela crescente do tráfego real da internet como algo secundário.
Por que devem existir cotas tanto por conta quanto por rede
Uma cota por conta acompanha quem você é. Uma cota por rede acompanha de onde o seu tráfego realmente vem. Um sistema sério precisa das duas.
Um formato de erro mais limpo em todos os endpoints
Todos os endpoints agora retornam erros em um formato único e consistente, o que facilita detectar, registrar e tratar falhas de forma programática.
Por que APIs só com webhook excluem discretamente quem trabalha em lote
Um webhook funciona bem para uma requisição de cada vez. Funciona mal para um script que só quer enviar mil consultas e esperar mil respostas.
Por que publicamos nossos códigos de erro em vez de escondê-los
Um código de erro não documentado transforma cada requisição com falha em um jogo de adivinhação. Publicar a lista é uma coisa pequena que economiza tempo real de depuração.
Por que o preço em lote deve ser igual ao preço por requisição avulsa
Mil consultas enviadas uma de cada vez e mil consultas enviadas em lote são a mesma quantidade de trabalho. O preço não deveria depender de como elas foram empacotadas.
Em defesa de um versionamento de API chato e estável
Uma nova versão empolgante de uma API é um projeto de migração para todos que dependem dela. Um versionamento chato e estável é um recurso, não falta de ambição.
Por que não criamos primeiro um SDK para navegador
Um SDK de navegador para uma consulta feita no servidor, na maioria das vezes, só leva a sua chave de API para um lugar onde o navegador do visitante pode vê-la. Essa não é uma conveniência que valha a pena.
O que a limitação de taxa por rede resolve e os limites por chave não
Um limite apenas por chave presume que uma chave equivale a um usuário. A limitação de taxa por rede fecha a brecha em que essa suposição silenciosamente deixa de valer.
Códigos postais merecem mais respeito do que recebem
As consultas de código postal são tratadas como um utilitário menor ao lado da geocodificação, mas têm estrutura real e variação regional real que merecem o mesmo cuidado.
Por que a qualidade da documentação importa mais do que a quantidade de recursos
Um recurso que você não consegue descobrir como usar é o mesmo que não existir. Documentação não é um custo de suporte, é parte do produto de verdade.
O custo silencioso da dependência de fornecedor
A dependência de fornecedor raramente aparece como uma única decisão ruim. Ela aparece como cem pequenas decisões que, silenciosamente, fazem sair custar muito mais do que simplesmente ficar.
Limites de taxa devem ser documentados, não descobertos
Descobrir o seu limite de taxa por meio de um erro 429 em produção não é documentação. É um chamado de suporte que nunca deveria ter precisado existir.
Por que contamos requisições em lote por item, e não por chamada
Uma chamada em lote com mil endereços ainda faz mil consultas separadas. Contá-la como uma única requisição só esconderia para onde o uso real foi.
Contra formatos de resposta proprietários
Um nome de campo proprietário ou um modelo de objeto personalizado não economiza nada para o provedor e custa ao cliente uma reescrita depois. JSON simples e previsível não é um recurso que está faltando.
O que a cobrança por produto erra sobre como as APIs são usadas
Aplicações reais misturam geocodificação, consultas de IP e chamadas de fuso horário no mesmo fluxo de requisição. Cobrá-las como produtos separados ignora como elas são usadas em conjunto.
Dados abertos de fuso horário não deveriam ser um recurso premium
As consultas de fuso horário usam uma fonte de dados pública e mantida ativamente. Cobrar um valor premium à parte por essa consulta não reflete um custo adicional real.
Por que hosts de compatibilidade importam mais do que um novo SDK
Um SDK pede que você confie na biblioteca cliente de uma empresa durante toda a vida do seu projeto. Um host de compatibilidade pede que você mude uma linha de configuração.
Por que cobramos por requisição, e não por usuário
Um preço por requisição corresponde ao que uma API realmente custa para funcionar. O preço por usuário mede número de pessoas, não uso, e o tráfego de geocodificação raramente segue qualquer um dos dois.