Web-service DRIVE

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

Взаимодействие осуществляется через механизм веб-сервисов по протоколу REST. API ключ для доступа к веб-сервису можно найти в Вашем профиле пользователя https://drive.co.ua/profile/.

Внимание! При работе по веб-сервисам существует ограничение на общее количество поисковых запросов в сутки. По умолчанию, это значение равно 1000. В случае превышения данного значения веб-сервис вернет соответствующую ошибку.

Общая информация

Метод вызова: POST

Формат ответа: JSON

Структура ответа:

• info - Информация о запросе
  • status - Статус успешного выполнение запроса (true или false)
  • mes - Текстовое сообщение о статусе запроса
• data - Данные

Пример реализации на PHP можно скачать по ссылке https://drive.co.ua/uploads/drive_api_example_v2.zip. 

Перечень текущих методов

Search 1.0.2

Описание: Поиск товаров

URL метода: https://drive.co.ua/api/search/

Параметры:

• api_key - API ключ (обязательный)
• article - Артикул товара (обязательный)
• brand - Бренд товара
• show_analog - Признак поиска с учетом аналогов (По умолчанию 1)
  • 0 - Без учета аналогов
  • 1 - С аналогами. (Рекомендуем)
  • 2 - С аналогами (расширенный). Выполняется дольше, чем с параметром 1, но показывает более широкий ассортимент товаров.

Структура ответа data:

• item_id - ID товара
• article - Артикул товара
• oe - Оригинальный номер товара
• brand - Бренд товара
• price - Цена товара (Показывается персональная цена для каждого пользователя с учетом скидок)
• cur - Валюта цены
• amount - Количество товара в наличии
• analog - Признак аналога
  • 0 - Оригинальный номер
  • 1 - Аналог
• group_name - Группа товара
• sub_group_name - Подгруппа товара
• desc - Описание товара

Order 1.0.1

Описание: Выполнение заказа клиента

URL метода: https://drive.co.ua/api/order/

Параметры:

• api_key - API ключ (обязательный)
• items - Массив товаров для заказа в формате json (обязательный)
  • item_id - ID товара
  • amount - Количество товара
• comment - комментарий к заказу

Структура ответа data:

• order_id - ID заказа 
• items - Массив товаров в заказе
  • id - ID товара в заказе
  • order_id - ID заказа
  • order_time - Дата и время заказа (Unixtime)
  • status_id - ID статуса заказа
  • status_name - Статус заказа
  • item_id - ID товара
  • article - Артикул товара
  • oe - Оригинальный номер товара
  • brand - Бренд товара
  • price - Цена товара
  • cur - Валюта цены
  • amount - Количество товаров
  • group_name - Группа товара
  • sub_group_name - Подгруппа товара
  • desc - Описание товара

 Возможные ошибки:

• Укажите товары - При оформление заказа не указаны ID товаров
• Найдены не все товары - Не все ID товаров указаны корректно
• Ошибка оформления заказа - При оформление заказа произошла ошибка

Orders 1.0.1

Описание: Список заказов клиента (последние 200)

URL метода: https://drive.co.ua/api/orders/

Параметры:

• api_key - API ключ (обязательный)
• ids - массив id заказов в формате json

Структура ответа data:

orders - Массив заказов клиента

• order_id - ID заказа
• items - Массив товаров в заказе
  • id - ID товара в заказе
  • order_id - ID заказа
  • order_time - Дата и время заказа (Unixtime)
  • status_id - ID статуса заказа
  • status_name - Статус заказа
  • item_id - ID товара
  • article - Артикул товара
  • oe - Оригинальный номер товара
  • brand - Бренд товара
  • price - Цена товара
  • cur - Валюта цены
  • amount - Количество товаров
  • group_name - Группа товара
  • sub_group_name - Подгруппа товара
  • desc - Описание товара

Статусы в заказе:

• 210803 - Получен
• 210804 - В работе
• 210805 - Ожидает поставки
• 210806 - В резерве
• 210808 - Выдано
• 210810 - Отказ
• 0 - Нет статуса