https://dev.cepcerto.comAutenticação e ambientes das APIs CepCerto.
Escolha a credencial adequada para cada API, configure o ambiente e mantenha os tokens protegidos no servidor.
Cadastro rápido e acesso pelo painel CepCertoAutenticação — referência técnica
Escolha o assunto para consultar credenciais, parâmetros e exemplos de requisição. Para conhecer os serviços antes de integrar, veja a apresentação das APIs.
Teste primeiro em desenvolvimento. Gerar PIX cria uma cobrança; emitir postagem pode debitar saldo e contratar frete; cancelar postagem altera a operação e pode solicitar estorno.
Autenticação e ambientes
As três credenciais têm finalidades diferentes e não são intercambiáveis. Nunca publique tokens em código-fonte, exemplos ou repositórios.
| Credencial | Finalidade | Envio |
|---|---|---|
postage_token | Cotação operacional, saldo, PIX, postagem, cancelamento, rastreio, logradouro e comprovante. | JSON ou Authorization: Bearer, conforme o endpoint. |
consumption_key | APIs pagas de CEP e frete Correios. | Último segmento das URLs /ws/.... |
widget_public_key | Cotador instalado em sites. | Header X-CepCerto-Public-Key e JSON. |
https://cepcerto.comOs tokens ficam disponíveis na Área Restrita, no módulo Integração. A chave pública é administrada em Frete no seu site.
Regras por endpoint
Unidades, limites, campos obrigatórios, autenticação, consumo e códigos HTTP.
Teste antes de publicar
Use o ambiente de desenvolvimento e valide respostas antes de operar em produção.
Coleção Postman
Importe requisições, exemplos e environments oficiais para começar rapidamente.
Tudo o que você precisa saber
Posso usar a mesma chave em todas as APIs?
Não. O token de postagem, a chave de consulta e a chave pública do widget têm finalidades diferentes. Consulte a tabela de autenticação antes de integrar.
Onde encontro minhas credenciais?
Na Área Restrita, abra Integração para os tokens das APIs. A chave pública do widget fica no módulo Frete no seu site.
Economize tempo e organize seus envios com o CepCerto.
Compare fretes, gere etiquetas e acompanhe suas encomendas em uma única plataforma.