Chave de ambiente errado

chave_de_ambiente_errado

A chave é de um ambiente e o recurso é de outro.

O que aconteceu

Você usou uma chave evo_sk_test_ sobre um recurso de produção, ou uma evo_sk_live_ sobre um recurso de sandbox. Os dois ambientes são organizações separadas — não compartilham documentos, cota nem chaves.

Por que costuma acontecer

• A variável de ambiente do seu servidor aponta para a chave errada (o clássico: .env de homologação subiu para produção).
• Você guardou o id de um documento criado em sandbox e tentou consultá-lo em produção.
• A organização está suspensa ou cancelada: nesses estados a chave autentica leitura e exportação, mas não criação.

Como resolver

• Todo ERRO da API traz o campo ambiente — é o jeito mais confiável de saber contra qual ambiente sua chave está falando, e ele existe exatamente para este diagnóstico.
• Nas respostas de SUCESSO, o campo aparece onde faz sentido: POST /api/v1/documentos, GET /api/v1/uso e POST /api/v1/cadastro. Não escreva uma guarda que o exija em toda chamada — ela vai disparar em rotas que legitimamente não o devolvem.
• Para checar a chave uma vez, no arranque do seu serviço: GET /api/v1/uso devolve ambiente e não consome cota.
• Mantenha os ids de sandbox separados dos de produção — eles nunca se cruzam.
• Se a organização estiver suspensa por inadimplência, regularize o pagamento: a leitura continua funcionando durante toda a régua.

Relacionados

• chave_invalida — Chave de API inválida
• cota_do_plano_excedida — Cota do plano excedida

Ramifique sempre pelo campo codigo da resposta — ele é estável. Nunca pelo texto da mensagem nem por esta URL.