API портала RAIN-AUTO.ru

Интерфейс программирования приложений (application programming interface)

API для сайта — это скрипт, который принимает запросы и отдаёт результат не в виде обычной HTML страницы для браузеров, а в заданном формате. API предназначен не пользователям, а скрипту со стороннего сайта, который посылает запросы, получает результат и как-то использует данные.
Подробнее>>

Данная информация предназначена для IT специалистов, работающих в сфере торговли авто компонентами.

API сайта www.rain-auto.ru позволяет находить товары по артикулу (коду) за один или два шага. В случае, если в базе данных артикул принадлежит только одному бренду (производителю), то по запросу будут выданы товары. В том случае, если артикул может принадлежать нескольким производителям, по запросу будет выдан список производителей с соответствующими url для запроса товаров.

Доступ к API предоставляется только зарегистрированным посетителям, которым предоставлен пин-код доступа. Компания «Дождь» оставляет за собой право не предоставлять или отключать доступ к API сайта.

Адрес для запроса: https://www.rain-auto.ru/search/api?lk=00000&key=0000&art=123

По запросу выдаются товары, соответствующие искомому артикулу и аналоги. Если в результатах выполнения запроса аналоги выводить не требуется, то необходимо добавить в url соответствующую переменную: &noanalogs=y.

Основные переменные в url запроса:
lk=00000 – код контрагента (номер личного кабинета) в компании Дождь;
key=0000 – пин-код, который можно получить по запросу;
art=123  - искомый артикул (код).

Дополнительно можно указать формат результирующего массива в переменной format:
пустое значение - php-дамп массива (по умолчанию)
serialize - результат работы соответствующей функции
json -результат работы функции json_encode()
days - ограничение на выдачу предложений по дням поставки
rain - выдвать только в наличии на складе (rain=y)

Результаты запроса выдаются в виде дампа массива PHP. Верхний уровень массива может быть:
[error] – нет доступа, не задан артикул или артикул не найден;
[brands] – необходимо выбрать производителя артикула;
[parts] – массив товаров;
[analogs]  - массив аналогов искомого артикула.

Массивы parts и analogs могут быть пустыми, что будет означать отсутствие соответствующих товаров в базе данных в данный момент. Товары в указанных массивах описываются следующими атрибутами:
[rain_id] - код Дождя;
[name] – наименование товара;
[brand] - название бренда;
[price]  - Ваша цена за 1 единицу товара;
[x] - кратность (минимальный заказ);
[mycode]  - код или артикул, присвоенный Клиентом данному товару – колонка Мой код;
[oem] – оригинальный(е) код (ы).  Если кодов OEM несколько, то они будут разделены запятой или объединены символом «+», в случае если товар состоит из нескольких деталей с собственными OEM номерами.
[days] – количество календарных дней поставки.  Значение 999 будет указывать не неизвестный в данный момент срок поставки.
[stock] – наличие на складе, которое принимает значение 0-9 или +, если остаток больше 10 шт.;
[img] - url картинки;
[tn]  - url превью картинки;
[ta] – тип аналога (только в массиве analogs), который принимает значения: "аналог", "состоит из" или "входит в состав". Список значений может быть расширен.

Рассмотрим результаты поиска артикула 123…

….

Артикул 123  принадлежит нескольким производителям. Во фрагменте результатов это WEEN и TSN. Необходимо выбрать один из вариантов и добавить значение  href к url запроса. Например, в случае выбора TSN, товары будут выданы по следующему url: https://api.rain-auto.ru/search/api?lk=00000&key=0000&art=123&brand=148