INTRODUÇÃO & ARQUITETURA

Visão Geral da API

O GeoCEP é a infraestrutura brasileira de inteligência geoespacial e dados de endereçamento com 111M+ de endereços mapeados e latência sub-2ms em cache.

Primeira Requisição em 5 Segundos

Você pode começar a testar a API imediatamente sem precisar de cadastro ou chave de API (até 100 requisições/hora por IP).

curl -s "https://api.geocep.api.br/v1/cep/01310-100?numero=2644"

🌐 Modo público: Gratuito até 100 requisições/hora por IP sem cadastro.HTTPS / TLS 1.3

Protocolos & Padrões

Base URL de Produção

https://api.geocep.api.br

Criptografia & Transporte

HTTPS Obrigatório / TLS 1.3 / HTTP/3 QUIC

Projeção Cartográfica

WGS84 padrão global (EPSG:4326)

Catálogo de Erros

Conformidade RFC 7807 Problem Details

Autenticação & Limites de Requisições

A API suporta dois métodos de autenticação para clientes com cotas contratuais:

Opção 1: X-API-Key: gc_live_sua_chave_aqui

Opção 2: Authorization: Bearer gc_live_sua_chave_aqui

Toda resposta de requisição autenticada inclui os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

Próximo tópico:Níveis de Precisão de Coordenadas