Menu

API
Техническая документация для интеграции с внешними сервисами

Перед началом работы необходимо получить уникальный ключ для работы с методами API.
Ключ выдаётся по запросу ответственным сотрудником компании.

Методы

Метод Формат запроса Результат (формат: JSON, кодировка: UTF-8)
categories https://www.evels.ru/api/v.1/json/{YOUR_API_KEY}/categories/ Возвращает дерево активных категорий
items https://www.evels.ru/api/v.1/json/{YOUR_API_KEY}/items/ Возвращает список товаров без учета категории. Максимальное количество результатов на один запрос - 100 товаров. Также на каждый запрос возвращяется общее количество товаров в выборке, и учитывая максимальное кол-во товаров в результате и общее кол-во выборке можно выбирать товары имитируя постраничную навигацию. Для того чтобы получить следующий пакет товаров, добавьте к запросу параметр page.
Например: https://www.evels.ru/api/v.1/json/{YOUR_API_KEY}/items/?page=2 - выберет 100 товаров начиная со второй страницы.
items + категория https://www.evels.ru/api/v.1/json/{YOUR_API_KEY}/items/{CATEGORY_ID}/ Возвращает список товаров с учётом вхождения в категорию, включая все вложенные (при наличии). Количество товаров в результате обработки запроса, а также постраничная выборка аналогично методу items
item https://www.evels.ru/api/v.1/json/{YOUR_API_KEY}/item/{ITEM_ID}/ Возвращает детальную информацию о товаре

Коды ошибок

Код Описание
0 Нет ошибок
1 Не корректный API ключ
2 Товар не найден

Условные сокращения

{YOUR_API_KEY} Ваш API ключ
{CATEGORY_ID} ID категории
{ITEM_ID} ID товара