API Автоселс

ОПИСАНИЕ МЕТОДОВ API АВТОСЕЛС

В данном примере приведено описание методов API Автоселс. С помощью данного API, оптовые покупатели (владельцы интернет-магазинов) могут подключаться к нашему интернет магазину и получать с него список товаров, наличие, сроки и оптовые цены. А также оформлять заказы прямо с вашего сайта.

 

API принимает POST-запросы на адрес: <<!-Домен сайта-!>>/web_service/api.php

--------------------------------------------------

get_offices - Запрос списка магазинов

--------------------------------------------------

 

// Входные параметры:

 

action - Метод API - get_offices

login - Логин для авторизации на сайте

password - Пароль для авторизации на сайте

// Пример запроса на PHP:

$postdata = http_build_query(

         array(

                'action' => "get_offices",

                'login' => "user@****.ru",

                'password' => "*********",

         )

);

 

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "<<!-Домен сайта-!>>/web_service/api.php");

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_POST, true);

curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);

curl_setopt($curl, CURLOPT_BINARYTRANSFER, true);

curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 30);

curl_setopt($curl, CURLOPT_TIMEOUT, 30);

curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);

$curl_result = curl_exec($curl);

curl_close($curl);

$answer = json_decode($curl_result, true);

 

// В ответ на запрос возвращается JSON строка. Элементы ответа:

 

result - (bool) - Статус

message - (string) - Сообщение

offices - (array) - Массив магазинов

 

// Свойства магазина (offices):

 

id - (string) - ID магазина, используется для запросов к другим методам api

caption - (string) - Название магазина

country - (string) - Страна

region - (string) - Регион

city - (string) - Город

address - (string) - Адрес

phone - (string) - Телефон

email - (string) - Почта

description - (string) - Описание точки выдачи

timetable - (string) - Время работы

 

--------------------------------------------------

get_brends - Запрос списка производителей

--------------------------------------------------

 

// Входные параметры:

 

action - Метод API - get_brends

login - Логин для авторизации на сайте

password - Пароль для авторизации на сайте

offices - Массив id магазинов в формате JSON (Необязательно. Если не передан, поиск происходит по всем магазинам)

article - Артикул товара

 

// Пример запроса на PHP:

 

$postdata = http_build_query(

         array(

                'action' => "get_brends",

                'login' => "user@****.ru",

                'password' => "*********",

                'offices' => json_encode(array(2)),

                'article' => "OC247",

         )

);

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "<<!-Домен сайта-!>>/web_service/api.php");

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_POST, true);

curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);

curl_setopt($curl, CURLOPT_BINARYTRANSFER, true);

curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 30);

curl_setopt($curl, CURLOPT_TIMEOUT, 30);

curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);

$curl_result = curl_exec($curl);

curl_close($curl);

$answer = json_decode($curl_result, true);

 

// В ответ на запрос возвращается JSON строка. Элементы ответа:

 

result - (bool) - Статус

message - (string) - Сообщение

brends - (array) - Массив производителей

 

// Свойства производителей (brends):

 

manufacturer - (string) - Наименование бренда

article - (string) - Запрошенный артикул

name - (string) - Наименование товара

manufacturers - (array) - Технический массив полного списка синонимов бренда, используется для запросов к другим методам api

 

--------------------------------------------------

get_products - Запрос списка товаров

--------------------------------------------------

 

// Входные параметры:

 

action - Метод API - get_products

login - Логин для авторизации на сайте

password - Пароль для авторизации на сайте

offices - Массив id магазинов в формате JSON (Необязательно. Если не передан, поиск происходит по всем магазинам)

article - Артикул товара

manufacturers - Массив брендов в формате JSON, полученный в методе get_brends

 

// Пример запроса на PHP:

 

$postdata = http_build_query(

           array(

                 'action' => "get_products",

                 'login' => "user@****.ru",

                 'password' => "*********",

                 'offices' => json_encode(array(2)),

                 'article' => "OC247",

                 'manufacturers' => '[{"manufacturer":"KNECHT\/MAHLE","manufacturer_id":0,"manufacturer_show":"KNECHT\/MAHLE"," name":"Фильтр","storage_id":0,"office_id":0,"synonyms_single_que ry":true,"params":                                                 {"type":"prices"},"valid":true}]',

          )

);

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "<<!-Домен сайта-!>>/web_service/api.php");

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_POST, true);

curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);

curl_setopt($curl, CURLOPT_BINARYTRANSFER, true);

curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 30);

curl_setopt($curl, CURLOPT_TIMEOUT, 30);

curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);

$curl_result = curl_exec($curl);

curl_close($curl);

$answer = json_decode($curl_result, true);

 

// В ответ на запрос возвращается JSON строка. Элементы ответа:

 

result - (bool) - Статус

message - (string) - Сообщение

products - (array) - Массив товаров

 

// Свойства товаров (products):

 

manufacturer - (string) - Наименование бренда

article - (string) - Запрошенный артикул

article_show - (string) - Запрошенный артикул, не очищенный от разделителей

name - (string) - Наименование товара

exist - (int) - Количество в наличии

price - (float) - Цена

time_to_exe - (int) - Ожидаемый срок доставки, дн.

time_to_exe_guaranteed - (int) - Гарантированный срок доставки, дн.

storage - (string) - Доп. информация о складе

min_order - (int) - Мин. партия для заказа

probability - (int) - Вероятность поставки, процент

office_id - (string) - ID магазина

storage_id - (string) - ID склада

office_caption - (string) - Наименование магазина

color - (string) - Цвет склада

 

Вот и всё! Наши товары, остатки, сроки и оптовые цены должны отобразится на вашем сайте.

Если у Вас возникнут вопросы с подключением нашей проценки, обращайтесь в нашу Службу поддержки: support@autosels.ru