Введение

API StocksTrader позволяет взаимодействовать с торговой платформой, однако ошибки могут возникать, если запросы оформлены неправильно. Это руководство объясняет наиболее частые коды ошибок — 400 Bad Request и 401 Unauthorized — и предлагает шаги для их устранения.

Частые коды ошибок

1. 400 — Bad Request (Неверный запрос)

Что это значит: Запрос содержит ошибку из-за неправильного URL, отсутствующих или некорректных параметров либо неверного формата данных.

Примеры:

• Использование /api/v1/logout/account вместо правильного /api/v1/logout.

• Отсутствие обязательных полей, таких как ticker, volume, side или type, в POST-запросе к /api/v1/accounts/{account_id}/orders.

• Неверный account_id или ticker в запросах, например, /api/v1/accounts/{account_id}/instruments/{ticker}.

Как исправить:

• Проверьте URL: Убедитесь, что он соответствует документации. Например, для выхода используйте /api/v1/logout, а не /api/v1/logout/account.

• Проверьте параметры: Убедитесь, что все обязательные параметры указаны и корректны. Например, в POST-запросе к /api/v1/accounts/{account_id}/orders должны быть ticker, volume, side и type.

• Проверьте формат данных: Убедитесь, что тело запроса соответствует ожидаемому формату.

• Изучите ответ: Посмотрите поле msg в ответе об ошибке для получения подсказок.

2. 401 — Unauthorized (Неавторизован)

Что это значит: В запросе отсутствует или недействителен токен авторизации.

Примеры:

• Доступ к /api/v1/accounts без Bearer-токена.

• Использование недействительного или просроченного токена.

Как исправить:

• Добавьте токен: Укажите заголовок Authorization в запросе.

• Проверьте токен: Если токен просрочен, сгенерируйте новый через веб-терминал StocksTrader.

• Проверьте права: Убедитесь, что токен принадлежит учётной записи с доступом к запрашиваемому ресурсу.

Общие рекомендации

• Изучайте документацию: Всегда сверяйтесь со спецификацией API для правильных эндпоинтов, параметров и форматов.

• Логируйте запросы: Сохраняйте полный запрос и ответ (включая поле msg) для анализа ошибок.

• Тестируйте заранее: Используйте инструменты вроде Postman для проверки запросов перед их внедрением.

• Обратитесь в поддержку: Если ошибка сохраняется, обратитесь в техподдержку, предоставив детали запроса (URL, тело и ответ).

Пример: Исправление ошибки 400

Проблема: Вы получили ошибку 400 при отправке POST-запроса на /api/v1/logout/account.

Решение:

• Проверьте документацию: правильный эндпоинт — /api/v1/logout.

• Обновите URL на https://api.stockstrader.com/api/v1/logout.

• Убедитесь, что это POST-запрос с корректным заголовком Authorization.

• Повторите запрос.

Пример: Исправление ошибки 401

Проблема: Вы получили ошибку 401 при отправке GET-запроса на /api/v1/accounts для получения списка учетных записей.

Решение:

• Проверьте заголовки: Убедитесь, что в запросе есть заголовок Authorization.

• Если заголовок отсутствует, добавьте его. Если токен просрочен — сгенерируйте новый через веб-терминал StocksTrader.

• Убедитесь, что токен принадлежит учётной записи с доступом к /api/v1/accounts.

• Повторите запрос с правильным токеном.