Para ligar o meu ecommerce ao seu site ou ao seu sistema, você usa uma de duas chaves. As duas ficam no painel, na aba Integrações.
Chave pública (pk_)
- Faz só cotação de frete.
- Pode ficar no código da página, no navegador. É a chave para calcular o frete no checkout de um site feito no Base44, no Bubble ou no seu próprio código.
- O painel mostra um exemplo pronto em Exemplo: cotar no checkout. Clique em Copiar código.
Chave secreta (mk_)
- Faz cotação e rastreio a partir do seu servidor.
- Também conecta o MCP em ferramentas de IA que pedem uma chave em vez de login.
- Nunca vai no código da página nem em repositórios, porque dá acesso ao rastreio e às ferramentas do MCP da sua loja, inclusive à emissão de etiquetas. Guarde em uma variável de ambiente do seu servidor.
- Por segurança, o painel mostra a chave secreta uma vez só, quando ela é criada. Copie e guarde na hora.
Como enviar a chave
Envie a chave no cabeçalho de cada chamada à API (https://api.meuecommerce.com.br):
Authorization: Bearer SUA_CHAVE
Gerar uma chave nova
Clique em Gerar nova chave na seção da chave que você quer trocar. A chave anterior para de funcionar na hora, então atualize o seu site ou o seu sistema logo em seguida. Se uma chave vazar, gere uma nova.
Erros de chave e o que fazer
- missing_api_key ou invalid_api_key: a chave não foi enviada ou está errada. Confira o cabeçalho e copie a chave de novo do painel.
- secret_key_required: você usou a chave pública para algo que exige a secreta, como o rastreio. Use a chave secreta, a partir do seu servidor.
- wrong_key_scope: a chave não tem permissão para essa operação. Confira se está usando a chave certa.
As chaves do meu ecommerce não são a senha nem o código de acesso do seu contrato com os Correios. Os dados do contrato ficam na aba Frete, em Contrato dos Correios.
Os detalhes técnicos estão no portal de desenvolvedores.