Guia
Como consultar CEP (endereço) pela API pública do Seu Rastreio
Para quem lidera a operação e quem implementa a integração.
A API de CEP devolve o endereço a partir de oito dígitos, com a mesma chave dos outros módulos. Use no checkout e em integrações para preencher cidade, bairro e logradouro com menos digitação manual e menos abandono de carrinho. O cache (prazo indicado em /api-docs/cep) alivia picos de tráfego.
TI: `GET /api/public/cep/{cep}`, com ou sem hífen no path conforme a documentação, `Authorization: Bearer` e tabela de erros na própria página. Comercial: contrato de API claro, documentado, alinhado ao escopo com agência ou fábrica de software.
Como conectar o CEP no seu fluxo
- Normalizar o CEP. 8 dígitos, com regras de hífen conforme /api-docs/cep.
- Chamar GET com Bearer. Inclua Authorization: Bearer e interprete a resposta JSON documentada.
- Respeitar limites e cache. Ajuste frequência de consulta; use cache de aplicação quando fizer sentido no checkout.
Contrato, cache e códigos HTTP
Zero à esquerda importa: normalize o CEP no servidor (apenas dígitos) antes de montar a URL, conforme a documentação, para evitar erro de validação.
A mesma página descreve códigos 401, 404, 429 e o comportamento de cache. Siga a tabela para o tratamento de erros e o monitoramento do seu serviço.
E-commerce, ERP e qualidade de endereço
Mapeie logradouro, bairro, cidade, UF para o pedido, mas mantenha a conferência humana quando o CEP atender a mais de um logradouro. Se usar /api/public/pedidos, alinhe o instantâneo de endereço ao corpo da requisição de pedido descrito na documentação de pedidos.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- A consulta de CEP funciona sem chave, como a home de rastreio?
- A API pública exige autenticação, como documentado. Sem a chave correta, a resposta será 401, não o preenchimento do endereço.
Próximo passo: documentação oficial
Parâmetros, tabelas de resposta, limites e exemplos em código — tudo na referência de API pública.
Atualizado em 23/04/2026