Ambientes

A Carrot API utiliza separação de ambientes baseada em credenciais, com a mesma URL base.

Modelo de ambientes

• URL base da API: https://api.carrot.eco
• URL de autenticação: https://auth.api.carrot.eco/oauth2/token
• O ambiente é selecionado pelo par de credenciais (clientId / clientSecret), não pelo host.

Comportamento: teste vs. produção

• Credenciais de teste operam apenas em dados de teste.
• Credenciais de produção operam apenas em dados de produção.
• Relacionamentos entre ambientes não são permitidos.

Recomendações para o ciclo de vida das credenciais

• Armazene as credenciais em seu gerenciador de segredos.
• Faça a rotação das credenciais por meio de rollout controlado.
• Solicite novos bearer tokens antes da expiração.

Checklist de go-live

1. Valide o fluxo completo em teste (criação, adição de evento, upload de anexo, recuperação).
2. Confirme o comportamento de retentativas/idempotência com deduplicationId.
3. Confirme o comportamento de rate limit sob a vazão esperada.
4. Promova para credenciais de produção.

Referências relacionadas:

• Autenticação
• Rate Limits