FFINAUTON B2B · Docs
App modelo

Referência da API

Estratégias do cliente

O cliente escolhe entre as estratégias concedidas ao seu contrato. Efetivas = publicadas ∩ concedidas ao tenant ∩ sua restrição ∩ escolha do cliente.
GET/v1/users/:externalUserId/strategiesPUT/v1/users/:externalUserId/strategies
GET/v1/users/:externalUserId/strategies

Estratégias do cliente

Tela do clienteVer no app modelo: Risco e estratégia ↗

granted = o que o cliente pode escolher; selected = o que está escolhido.

Parâmetros de caminho

  • externalUserIdstring (1–120)obrigatório

    id do cliente no SEU sistema

Requisição
curl -X GET "$FIN_API/v1/users/cli-1001/strategies" \
  -u "$FIN_CLIENT_ID:$FIN_CLIENT_SECRET"
Resposta200
{
  "externalUserId": "cli-1001",
  "tenantId": "TENANT_A",
  "requestId": "req_muyn0w3r_bxagutu0",
  "granted": [
    "FUTURES_MAIN_V1"
  ],
  "selected": [
    "FUTURES_MAIN_V1"
  ],
  "selectionMode": "EXPLICIT"
}
PUT/v1/users/:externalUserId/strategies

Escolher estratégias

Tela do clienteVer no app modelo: Risco e estratégia ↗

Grava a escolha do cliente. null = todas as concedidas; [] = nenhuma (sem novas entradas).

Parâmetros de caminho

  • externalUserIdstring (1–120)obrigatório

    id do cliente no SEU sistema

Corpo (JSON)

  • strategyIdsstring[] | nullobrigatório

    estratégias escolhidas

Erros comuns

  • 403STRATEGY_NOT_AVAILABLEestratégia não publicada
  • 403GRANT_ESCALATIONfora do concedido
Requisição
curl -X PUT "$FIN_API/v1/users/cli-1001/strategies" \
  -u "$FIN_CLIENT_ID:$FIN_CLIENT_SECRET" \
  -H "content-type: application/json" \
  -d '{
    "strategyIds": [
      "FUTURES_MAIN_V1"
    ]
  }'
Resposta200
{
  "externalUserId": "cli-1001",
  "selected": [
    "FUTURES_MAIN_V1"
  ],
  "selectionMode": "EXPLICIT",
  "requestId": "req_muyn3wpf_bpztl9rq"
}