Ambientes e projetos

Ambientes isolam cupons, campanhas, catálogo, operações e credenciais. Projetos organizam integrações dentro de um ambiente e permitem acompanhar consumo e acessos por sistema.

O ambiente vem da API key

HML e PRD usam https://api.cupom.center. A API REST não recebe um header para selecionar ambiente: organização, ambiente e projeto são resolvidos exclusivamente pela credencial.

Isso evita que uma chave de teste acesse dados produtivos apenas pela alteração de um parâmetro.

Como separar integrações

Crie projetos distintos para sistemas ou responsabilidades que precisem de credenciais, métricas ou ciclos de rotação independentes. Não use uma única chave compartilhada entre todos os serviços.

Ferramentas locais

No Postman ou Insomnia, mantenha environments locais com os mesmos nomes de variáveis e valores diferentes. A collection é única; o environment selecionado fornece token, IDs e códigos correspondentes ao ambiente usado.

Promoção entre ambientes

Os dados são isolados e não mudam de ambiente automaticamente. Reproduza a configuração comercial desejada em produção por um processo controlado e valide a integração com a chave produtiva antes de liberar tráfego real.