O problema das chaves de API que nunca expiram
Uma chave emitida anos atrás, nunca trocada e ainda válida hoje não é uma conveniência. É um risco que ninguém examina de verdade há anos.
Por que as consultas de código postal merecem ser tratadas como prioridade
As prioridades de um produto aparecem na estrutura de preços e na profundidade da documentação muito antes de aparecerem em qualquer declaração explícita sobre o que mais importa. Um endpoint escondido em um plano de preço inferior, ou documentado em três frases ao lado de uma página totalmente detalhada para um recurso principal, está comunicando um fato real sobre a prioridade interna, quer alguém tenha tido a intenção de comunicá-lo ou não. A consulta de código postal é uma vítima comum desse padrão: tecnicamente disponível, raramente recebe investimento e é tratada como um utilitário menor em relação à geocodificação completa.
Definimos de propósito o mesmo preço para a consulta de código postal e para todos os outros endpoints, justamente para evitar esse rebaixamento silencioso. Ela está coberta pela mesma cota diária gratuita, é cobrada pelos mesmos € 0,0001 por requisição além disso ou está incluída na mesma chave Unlimited de € 50, exatamente como a geocodificação, a consulta de IP, o fuso horário ou a altitude. Não existe um plano com desconto que sinalize que a consulta postal é considerada menos valiosa, nem um plano premium que sinalize o contrário. Ela está no mesmo nível de todo o resto, porque achamos que deve estar.
O preço igual é um ponto de partida, não o argumento inteiro. O motivo mais profundo pelo qual a consulta de código postal merece tratamento de primeira classe é que os dados por trás dela realmente exigem a mesma seriedade que qualquer outro tipo de dado de localização. Os sistemas postais não são uma versão simplificada da geocodificação. Eles são uma categoria própria de estrutura, que varia de país para país no formato, no tamanho da área coberta por um único código e no quanto o código corresponde diretamente aos limites administrativos. Fazer isso corretamente em vários países exige atenção real e contínua, a mesma que um recurso principal de geocodificação recebe por padrão, porque se supõe que ele seja o importante.
Tratar um endpoint como de primeira classe também significa que ele recebe o mesmo padrão de documentação: exemplos reais, uma descrição clara de quais dados são retornados e como estão estruturados, e notas honestas sobre as limitações de cobertura por país, em vez de uma afirmação vaga e genérica. Um endpoint documentado de forma superficial porque se supõe que ele seja simples tende a continuar simples justamente nos aspectos que importam, porque ninguém olha com atenção suficiente para perceber onde ele deixa a desejar.
Há um retorno prático nisso, além da justiça na forma como distribuímos a atenção da engenharia. Muitas aplicações reais, como calculadoras de frete, verificações de jurisdição tributária e validação de área de atendimento, dependem mais diretamente de uma resolução correta do código postal do que de uma geocodificação completa no nível da rua. Tratar a consulta postal como um recurso menor em relação à geocodificação inverte a dependência real justamente para as aplicações que mais precisam desses dados. Dar a ela o mesmo preço e a mesma documentação não é um gesto simbólico. Está mais perto de corrigir um erro de categoria que o resto do setor, em grande parte, herdou sem examinar.