API версии 1

Все запросы должны совершаться с префиксом /v1/. Базовый uri - http://api.sell-of.ru.

http://api.sell-of.ru/v1/***

Все запросы должны содержать Apikey в теле запроса. Apikey - строка из 40 символов, например:

apikey: Ключь можно получить по запросу на почту info@russian-bridge.ru

API возвращает данные в формате JSON.

Структура ответа:
{
  "data": {
    // данные, сооветствующие запросу
  },
  "meta": {
    // метаданные
  }
}

Метаданные содержат информацию об общем количестве элементов в массиве "data", и пагинации (количество товаров на странице, номер страницы, ссылку на следующую страницу).

Количество элементов на странице устанавливается параметром limit в теле запроса.

Номер страницы устанавливается параметром page в теле запроса.

Конечные точки API

КАТЕГОРИИ:

GET/categories - возвращает список категорий, содержащих товары на продажу.

GET/categories/{categoryId}/items - возвращает список товаров в категории.

GET/categories/{categoryId}/items/{itemId} - возвращает описание указанного товара в указанной категории.

ТОВАРЫ:

GET /items - возвращает список всех товаров на продажу.

GET /items/search/{query} - возвращает список товаров, соответствующих поисковому запросу (query).


Пример каталога по API доступу сделан на сейте: www.sell-of.ru