APIs externas (proxies autenticados)
Módulo: ExternalApisModule
Auth: Bearer em todas
Tag: APIs externas
Catálogo: catalogo-completo.md §12.
O CentralCRM faz proxy autenticado para serviços públicos externos.
| Método | Rota CentralCRM | Upstream |
|---|---|---|
GET | /api/v1/external-apis/opencnpj/:cnpj | https://api.opencnpj.org/{CNPJ} |
GET | /api/v1/external-apis/cep/v1/:cep | https://brasilapi.com.br/api/cep/v1/{cep} |
GET | /api/v1/external-apis/cep/v2/:cep | https://brasilapi.com.br/api/cep/v2/{cep} |
GET | /api/v1/external-apis/banks/v1 | https://brasilapi.com.br/api/banks/v1 |
Controllers
| Controller | Path |
|---|---|
OpencnpjV1Controller | external-apis/opencnpj |
BrasilApiCepV1Controller | external-apis/cep |
BrasilApiBanksV1Controller | external-apis/banks |
Notas
- OpenCNPJ: CNPJ sem máscara (apenas dígitos) no path.
- CEP v2: inclui geolocalização quando disponível.
- Banks: lista de bancos brasileiros.
- Erros do upstream são mapeados para HTTP adequado (4xx/5xx) pelo serviço Nest.