La API de StocksTrader permite interactuar con la plataforma de trading, pero pueden producirse errores si las solicitudes no están correctamente formadas. Esta guía explica los códigos de error más comunes — 400 Bad Request y 401 Unauthorized — y ofrece pasos para solucionarlos.

Esta guía te ayudará a identificar y resolver rápidamente los errores más comunes de la API de StocksTrader.

Códigos de error comunes

1. 400 — Solicitud incorrecta (Bad Request)

Qué significa: La solicitud contiene un error debido a una URL incorrecta, parámetros faltantes o inválidos, o un formato de datos incorrecto.

Ejemplos:

• Usar /api/v1/logout/account en lugar de la ruta correcta /api/v1/logout
• Faltar campos obligatorios como ticker, volume, side o type en una solicitud POST a /api/v1/accounts/{account_id}/orders
• Proporcionar un account_id o ticker inválido en solicitudes como /api/v1/accounts/{account_id}/instruments/{ticker}

Cómo solucionarlo:

• Revisar la URL: Asegúrate de que coincida con la documentación de la API. Por ejemplo, usa /api/v1/logout en lugar de /api/v1/logout/account.
• Revisar los parámetros: Verifica que todos los parámetros requeridos estén incluidos y sean válidos. Por ejemplo, ticker, volume, side y type deben estar presentes en una solicitud POST.
• Revisar el formato de los datos: Asegúrate de que el cuerpo de la solicitud siga el formato esperado.
• Revisar la respuesta: Consulta el campo msg en la respuesta de error para obtener pistas sobre lo que salió mal.

2. 401 — No autorizado (Unauthorized)

Qué significa: La solicitud no contiene un token de autorización válido o el token es inválido.

Ejemplos:

• Acceder a /api/v1/accounts sin un token Bearer
• Usar un token expirado o inválido

Cómo solucionarlo:

• Incluir un token: Añade el encabezado Authorization a tu solicitud.
• Verificar el token: Si el token está expirado, genera uno nuevo desde el terminal web de StocksTrader.
• Verificar permisos: Asegúrate de que el token pertenezca a una cuenta con acceso al recurso solicitado.

Recomendaciones generales

• Consulta la documentación: Revisa siempre la especificación de la API para conocer los endpoints, parámetros y formatos correctos.
• Registra solicitudes y respuestas: Guarda la solicitud completa y la respuesta (incluido el campo msg) para analizar errores.
• Haz pruebas antes: Usa herramientas como Postman para verificar tus solicitudes antes de implementarlas.
• Contacta con soporte: Si el problema persiste, contacta con el soporte técnico y proporciona los detalles de la solicitud (URL, cuerpo y respuesta).

Ejemplo: Cómo solucionar un error 400

Problema: Recibes un error 400 al enviar una solicitud POST a /api/v1/logout/account.

Solución:

• Revisa la documentación: el endpoint correcto es /api/v1/logout.
• Actualiza la URL a https://api.stockstrader.com/api/v1/logout.
• Asegúrate de que sea una solicitud POST con el encabezado Authorization correcto.
• Vuelve a enviar la solicitud.

Ejemplo: Cómo solucionar un error 401

Problema: Recibes un error 401 al enviar una solicitud GET a /api/v1/accounts para obtener tu lista de cuentas.

Solución:

• Revisa los encabezados: asegúrate de que el encabezado Authorization esté presente.
• Si falta, añádelo. Si el token está expirado, genera uno nuevo desde el terminal web de StocksTrader.
• Verifica que el token pertenezca a una cuenta con acceso a /api/v1/accounts.
• Reintenta la solicitud con un token válido.