63 Колеса

Введение

Начало работы

Перед использованием API вам потребуется:

  1. Получить API-ключ для аутентификации
  2. Добавить ключ в заголовок запроса: X-API-KEY: <ваш_ключ>
  3. Ознакомиться с доступными методами API

Основные возможности API

Наш API предоставляет следующие ключевые функции:

МетодЭндпоинтОписание
GET/api/v1/meПолучение информации о вашем аккаунте
GET/api/v1/productsДоступ к каталогу товаров
GET/api/v1/products/:idПодробная информация о конкретном товаре
GET/api/v1/ordersПросмотр истории заказов
GET/api/v1/orders/:idДетализация конкретного заказа
POST/api/v1/ordersСоздание новых заказов
DELETE/api/v1/orders/:idОтмена заказов

Обработка ошибок

При работе с API используйте HTTP-коды статуса для обработки возможных ошибок. В нашей системе реализована детализированная система ошибок, которая поможет вам быстро идентифицировать и решить возникшие проблемы.

Где найти информацию об ошибках:

  • На странице описания каждого API-метода вы найдете специальный раздел «Возможные ошибки»
  • Для каждого эндпоинта приведена таблица с:
    • Кодами ошибок
    • Их описанием
    • Рекомендованными действиями для решения

Рекомендации по работе с ошибками:

  1. Всегда проверяйте HTTP-статус ответа
  2. Реализуйте в вашем коде обработку наиболее частых ошибок
  3. Для сложных случаев обратитесь к документации конкретного метода

Напоминаем, что полный перечень возможных ошибок и способов их устранения доступен в описании каждого API-метода в соответствующем разделе документации.