Seu primeiro request

Vamos fazer a integração “dizer olá”. O objetivo aqui é só confirmar que sua credencial funciona e que você consegue autenticar — usando uma chamada somente leitura e sem efeito colateral: listar as linhas de crédito ativas do seu parceiro.

Obtenha um token


curl -X POST https://econsignado-api.socinal.com.br/v1/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "cli_a1b2c3",
    "client_secret": "sk_live_..."
  }'

Guarde o access_token da resposta.

Liste as linhas de crédito


curl https://econsignado-api.socinal.com.br/v1/linhas-credito \
  -H 'Authorization: Bearer SEU_TOKEN'

Resposta (exemplo):


[
  {
    "numero_linha": "92",
    "prazo_minimo": 6,
    "prazo_maximo": 48,
    "valor_minimo": 1,
    "valor_maximo": 100000,
    "taxa_minima": null,
    "taxa_maxima": null,
    "tem_seguro": false
  }
]

A lista traz só as linhas ativas do seu parceiro. Os limites (prazo_*, valor_*) e as taxas são os cadastrados para você — os do exemplo acima são ilustrativos e não valem para a sua credencial.

Guarde o numero_linha da linha que você vai usar — é ele (não um id) que os demais endpoints exigem: /v1/simulacao, /v1/propostas e /v1/emprestimos.

taxa_minima e taxa_maxima podem vir null quando a linha não tem faixa de taxa cadastrada — os campos existem sempre, mas o valor pode não estar preenchido. Nesse caso informe taxa_mensal na simulação ou deixe o servidor aplicar a taxa padrão do parceiro.

Deu certo?

Se você recebeu a lista (mesmo que vazia), sua autenticação está funcionando. Agora vale entender o produto antes de originar de verdade:

Como funciona o crédito — o glossário e a lógica do consignado
Ciclo de vida da operação — a ordem das chamadas
Fluxo completo — o passo a passo ponta a ponta

Não funcionou?

Resposta	Provável causa
`401 CREDENCIAL_INVALIDA`	Token errado, expirado, ou faltou o header `Authorization`
`403 ESCOPO_INSUFICIENTE`	A credencial não tem o escopo `credito:read`
`429 RATE_LIMIT_EXCEDIDO`	Muitas chamadas — aguarde o tempo do `Retry-After`