3.1. Financiadores¶
🔗 Endpoint¶
| Método | URL |
|---|---|
/public/v1/financiadores |
🧾 Descrição¶
Retorna a lista de financiadores disponíveis para utilização na criação de uma Nota Comercial.
- Caso a chave de acesso pertença a um parceiro, apenas os financiadores vinculados ao parceiro serão retornados.
- Caso a chave pertença a um estruturador, todos os financiadores disponíveis serão retornados.
Não é possível cadastrar novos financiadores via API.
🧪 Exemplo de cURL¶
curl -X GET https://api.vehub.com.br/public/v1/financiadores \
-H "Authorization: Bearer {seu_token}" \
-H "GrupoEconomico: {seu_grupo_economico}"
📥 Responses¶
✅ 200 OK¶
[
{
"id": 1,
"nome": "Financiadora Alpha S.A.",
"documento": "12345678000199"
},
{
"id": 2,
"nome": "Fundo Beta de Investimentos",
"documento": "98765432000155"
}
]
Detalhamento dos Campos¶
| Campo | Tipo | Descrição |
|---|---|---|
| id | integer | Identificador único do financiador |
| nome | string | Razão social do financiador |
| documento | string | CNPJ do financiador (somente números) |
❌ 401 Unauthorized¶
{
"tipo": "https://tools.ietf.org/html/rfc9110#section-15.6.2",
"titulo": "Não autorizado",
"status": 401,
"erros": ["Token de autenticação inválido ou expirado."]
}