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.
Códigos postais merecem mais respeito do que recebem
Peça a lista de recursos de uma API de localização e a geocodificação normalmente vem primeiro, as consultas de IP em seguida, e os códigos postais aparecem em algum lugar perto do fim, descritos em uma única linha, como se resolver um código postal para um lugar, ou um lugar para o seu código postal, fosse uma consulta trivial com uma única resposta óbvia. Não é. Os sistemas postais variam enormemente de país para país: alguns codificam a hierarquia administrativa diretamente nos dígitos, alguns são alfanuméricos, alguns cobrem uma área do tamanho de um bairro e outros cobrem uma área do tamanho de um país pequeno. Tratar isso como um endpoint utilitário menor subestima quanta estrutura real existe por trás dele.
Criamos as consultas de código postal como um endpoint de primeira classe ao lado de geocodificação, IP, fuso horário e altitude, e não como um complemento acrescentado à resposta de geocodificação. Ele tem o mesmo preço de todos os outros endpoints: coberto pela cota gratuita diária e, depois, os mesmos € 0,0001 por requisição ou a mesma chave Unlimited de € 50 que qualquer outro. Não existe uma categoria separada de "endpoints utilitários" que trate as consultas postais como um recurso inferior, digno de um preço inferior e, implicitamente, de menos atenção de engenharia.
Parte do motivo pelo qual os códigos postais são subestimados é que eles parecem simples vistos de um país onde o sistema é um número fixo de dígitos mapeado de forma limpa para uma área pequena. Essa simplicidade não se generaliza. Uma consulta de código postal precisa realmente lidar com a variedade de formatos e significados administrativos que existem em diferentes países, e não apenas com o padrão mais familiar para quem criou o recurso. Uma API que presume silenciosamente o formato postal de um país como padrão e trata todo o resto como caso extremo não está realmente oferecendo suporte global a códigos postais. Está oferecendo o sistema de um país com uma cobertura limitada acoplada.
Isso tem consequências práticas fáceis de ignorar até que causem um problema. Cálculos de frete, consultas de jurisdição tributária, verificações de área de atendimento e preços regionais dependem de acertar a camada de código postal, muitas vezes de forma mais direta do que dependem de uma geocodificação completa no nível da rua. Uma cotação de frete normalmente não precisa de um endereço com precisão de telhado. Ela precisa de uma região postal correta, resolvida de forma consistente. Tratar isso como um recurso menor em relação à geocodificação completa inverte a dependência real para muitas aplicações de verdade.
Não estamos afirmando que os dados de códigos postais são um problema resolvido no mundo todo, porque os sistemas postais continuam mudando e a qualidade da cobertura realmente varia por país e pela frequência com que cada autoridade postal publica atualizações. O que estamos dizendo é que eles merecem a mesma seriedade de qualquer outro endpoint: documentação de verdade, o mesmo preço de todo o resto e a mesma expectativa de que continuem funcionando corretamente, em vez de ser o canto do produto que ninguém revisita depois que ele tecnicamente passa a retornar uma resposta.