A API do StocksTrader permite a interação com a plataforma de negociação, mas erros podem ocorrer se as requisições não forem formatadas corretamente. Este guia explica os códigos de erro mais comuns — 400 Bad Request e 401 Unauthorized — e apresenta orientações para resolvê-los.

Com este guia, você poderá identificar e corrigir rapidamente os erros mais comuns da API do StocksTrader.

Códigos de erro comuns

1. 400 – Requisição inválida (Bad Request)

O que significa: A requisição está incorreta — geralmente por causa de uma URL inválida, parâmetros ausentes ou inválidos, ou formato de dados incorreto.

Exemplos:

• Usar /api/v1/logout/account em vez de /api/v1/logout
• Omitir campos obrigatórios como ticker, volume, side ou type em um POST para /api/v1/accounts/{account_id}/orders
• Informar um account_id ou ticker inválido em chamadas como /api/v1/accounts/{account_id}/instruments/{ticker}

Como corrigir:

• Verifique a URL: Compare com a documentação da API.
• Verifique os parâmetros: Todos os parâmetros obrigatórios devem estar presentes e ser válidos.
• Verifique o formato dos dados: O corpo da requisição precisa seguir o formato esperado.
• Confira a resposta: O campo msg na resposta de erro pode indicar onde está o problema.

2. 401 – Não autorizado (Unauthorized)

O que significa: A requisição não contém um token de autorização válido ou o token está expirado/inválido.

Exemplos:

• Acessar /api/v1/accounts sem um token do tipo Bearer
• Usar um token inválido ou expirado

Como corrigir:

• Inclua o token: Adicione o cabeçalho Authorization na requisição.
• Verifique o token: Se ele estiver expirado, gere um novo no terminal web do StocksTrader.
• Verifique as permissões: O token deve pertencer a uma conta com acesso ao recurso solicitado.

Recomendações gerais

• Consulte a documentação: Sempre siga a especificação oficial da API — endpoints corretos, parâmetros e formatos.
• Registre requisições e respostas: Salve o conteúdo completo da requisição e resposta (incluindo o campo msg) para análise posterior.
• Teste antes: Utilize ferramentas como o Postman para validar suas requisições antes da implementação.
• Entre em contato com o suporte: Se o problema persistir, envie os detalhes da requisição (URL, corpo e resposta) para o suporte técnico.

Exemplo: Corrigindo um erro 400

Problema: Você recebe um erro 400 ao enviar um POST para /api/v1/logout/account.

Solução:

1. Consulte a documentação — o endpoint correto é /api/v1/logout.

2. Atualize a URL para https://api.stockstrader.com/api/v1/logout.

3. Certifique-se de que é uma requisição POST com o cabeçalho Authorization adequado.

4. Envie a requisição novamente.

Exemplo: Corrigindo um erro 401

Problema: Você recebe um erro 401 ao tentar obter a lista de contas com um GET para /api/v1/accounts.

Solução:

1. Verifique os cabeçalhos — o cabeçalho Authorization precisa estar presente.

2. Se estiver ausente, adicione-o. Se o token estiver expirado, gere um novo no terminal web do StocksTrader.

3. Certifique-se de que o token pertence a uma conta com acesso a /api/v1/accounts.

4. Tente novamente com um token válido.