Vorexy
IntroCriarSaldoHooksErros

Autenticacao

A API utiliza autenticacao via X-Client-Id e X-API-Key. Para operacoes sensiveis (criar transacao e saque), e obrigatorio o token de operacao.

Headers Obrigatorios (Base)

Headers
X-Client-Id: e1c98954cc404cbcb2868af9b40c7a33
X-API-Key: sua-api-key-secreta
Content-Type: application/json
Accept: application/json

Token de Operacao (Obrigatorio)

Para criar transacoes e solicitar saques, e necessario gerar um token de operacao adicional. Este token adiciona uma camada extra de seguranca.

Fluxo Obrigatorio

1

Gerar token de operacao com suas credenciais (X-Client-Id e X-API-Key)

2

Enviar o token no header X-Operation-Token nas chamadas de criar transacao ou saque

Endpoint para Gerar Token

POST/api/v1/operation-auth/token

Alias disponivel: POST /api/Transaction/auth/token

Request Body (Opcional)

Body
{
  "scopes": ["transaction:create", "cashout:create"],
  "expiresInSeconds": 300
}
  • • expiresInSeconds: minimo 30, maximo 3600, padrao 300
  • • scopes: se omitido, usa transaction:create e cashout:create

Response 200

Response
{
  "tokenType": "Bearer",
  "headerName": "X-Operation-Token",
  "expiresInSeconds": 300,
  "scope": ["transaction:create", "cashout:create"],
  "token": "<jwt>"
}

Exemplo cURL

cURL
curl -X POST "https://vorexy.com/api/v1/operation-auth/token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Client-Id: <CLIENT_ID>" \
  -H "X-API-Key: <API_KEY>" \
  -d '{"scopes": ["transaction:create", "cashout:create"], "expiresInSeconds": 300}'

Header Adicional Obrigatorio

Header
X-Operation-Token: <token_gerado>

Obrigatorio para os endpoints de criacao de transacao (POST /api/v1/transactions/create) e solicitacao de saque (POST /api/Withdraw/request).

Erro de Token Invalido

401 Unauthorized
{
  "title": "Token de operacao invalido.",
  "detail": "Token invalido ou expirado.",
  "header": "X-Operation-Token"
}

Como Obter Credenciais

Para usar a API Vorexy, voce precisa de um par de credenciais: Client ID e API Key.

Passo a Passo

1

Acesse o painel em https://vorexy.com/login-company

2

Navegue ate Configuracoes -> API & Integracoes

3

Copie o Client ID (publico e unico para sua aplicacao)

4

Clique em Gerar Nova Chave para criar uma API Key

5

Guarde sua API Key em um local seguro (ela sera exibida apenas uma vez)

Importante

A API Key e secreta e deve ser armazenada com seguranca. Nunca a compartilhe ou exponha em codigo cliente.

Exemplo de Requisicao Autenticada

cURL
curl -X GET "https://vorexy.com/api/v1/transactions" \
  -H "Accept: application/json" \
  -H "X-Client-Id: e1c98954cc404cbcb2868af9b40c7a33" \
  -H "X-API-Key: sua-api-key-secreta"