Ambientes
URLs de staging e produção e como promover a integração com segurança.
A API de Integração tem dois ambientes. Valide tudo em staging antes de ir para produção.
URLs base
| Ambiente | URL base |
|---|---|
| Staging (homologação) | https://api-staging.principia.services/api-integracao |
| Produção | https://api.principia.services/api-integracao |
Staging e produção seguem o mesmo padrão de URL, só troca o domínio: as rotas ficam sob /api-integracao nos dois ambientes (ex.: .../api-integracao/v1/parcela).
Chaves por ambiente
Cada ambiente tem sua própria chave institucional. Nunca use a chave de produção em staging (ou vice-versa).
Roteiro de promoção para produção
- Rode o fluxo completo em staging com dados de teste.
- Valide o tratamento de erros e o reprocessamento de lotes.
- Troque a URL base e a chave para produção.
- Faça um teste controlado com um volume pequeno antes de escalar.