Ambientes e URLs
Toda a API é exposta por um gateway único (Azure API Management), que repassa as conexões para o backend. Você nunca chama os serviços internos diretamente — sempre o gateway.
| Ambiente | Host base | Uso |
|---|---|---|
| Produção | https://api.antecipafacil.net.br | Integrações reais |
| Staging | https://stg-api.antecipafacil.net.br | Testes e homologação, quando liberado para o parceiro |
Todos os caminhos da Referência da API são relativos a esses hosts. Ex.: o endpoint GET /api/company/ em produção é https://api.antecipafacil.net.br/api/company/.
Convenções
Seção intitulada “Convenções”- Protocolo: somente HTTPS.
- Formato: JSON (
Content-Type: application/json) em requisições e respostas. - Prefixo: os recursos da plataforma ficam sob
/api/. - Gateway: o APIM opera como repasse (
/*) — as rotas, métodos e payloads são exatamente os do backend. - Versão: os módulos principais usam prefixos como
/api/auth/v1,/api/company/v1,/api/v1/quotation,/api/v1/marketplace,/api/escrow-account/v1e/api/reports/v1.