API ГК-ПЛАСТИК

API сайта ГК ПЛАСТИК реализовано в виде запросов по HTTPS протоколу на URL, соответсвующие тем или иным функциям API. Все параметры запроса могут быть переданы как в виде GET-параметров, так и в теле POST запроса в url-encoded форме.

Общие параметры

Имя параметра Тип Обязательный Описание
UID Число Да Уникальный идентификатор API-клиента. Выдается администратором по запросу. Привязан к IP клиента.
DataType Строка Нет Формат ответа сервера. Принимает значения "JSON" и "XML". По умолчанию "JSON".

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

В случае ошибки авторизации (некорректный UID, IP-адрес, профиль не создан или не активен) выдаётся ошибка "ERROR: WRONG LOGIN" в виде простого текста;
В случае невозможности распознать ключевые параметры сервер возвращает ошибку "ERROR: PARSE KEYS";
В случае, если по запросу ничего не найдено, то возвращается пустой json-массив (вида "[]") или xml-файл (вида "<?xml version="1.0"?><data/>").

Поиск товаров

URL:
/api/search/
Параметры запроса:
Имя параметра Тип Обязательный Описание
Q Строка Да Строка поискового запроса
Ответ:
Имя параметра Описание
id Уникальный идентификатор товара в магазине ГК-ПЛАСТИК.
name Наименование детали
article Артикул детали
count Доступное количество деталей в формате:
"0-5" = точное количество,
"10-" = от 6 до 9,
"10+" = более или равно 10
price Цена детали
brand Брэнд детали
Пример запроса:
https://gkpl.ru/api/search/?UID=12345&DataType=JSON&Q=Scania
Пример ответа JSON:
[
    {
        "id":6357,
        "name":"Фара головного света с указателем поворота левая Scania",
        "article":"GK121533",
        "count":"2",
        "price":"4100.35"
    },
    {
        "id":6358,
        "name":"Фара головного света с указателем поворота правая Scania",
        "article":"GK121534",
        "count":"10+",
        "price":"4100.35"
    }
]
Пример ответа XML:
<?xml version="1.0"?>
<data>
    <item0>
        <id>6357</id>
        <name>Фара головного света с указателем поворота левая Scania</name>
        <article>GK121533</article>
        <count>2</count>
        <price>4100.35</price>
    </item0>
    <item1>
        <id>6358</id>
        <name>Фара головного света с указателем поворота правая Scania</name>
        <article>GK121534</article>
        <count>10+</count>
        <price>4100.35</price>
    </item1>
</data>

Информация о товаре

URL:
/api/product/
Параметры запроса:
Имя параметра Тип Обязательный Описание
ID Число Да Уникальный идентификатор товара в магазине ГК-ПЛАСТИК.
Stores bool Нет Выдача раздельно по складам. Выдаётся массив вместо одного элемента.
Ответ:
Имя параметра Описание
id Уникальный идентификатор товара в магазине ГК-ПЛАСТИК.
name Наименование детали
article Артикул детали
count Доступное количество деталей в формате:
"0-5" = точное количество,
"10-" = от 6 до 9,
"10+" = более или равно 10
price Цена детали
brand Брэнд детали
store Название склада (только если Stores указан true)
Пример запроса:
https://gkpl.ru/api/product/?UID=12345&DataType=JSON&ID=6357&Stores=true
Пример ответа JSON:
[
    {
        "id":6357,
        "name":"Фара головного света с указателем поворота левая Scania",
        "article":"GK121533",
        "count":"2",
        "price":"4100.35",
        "brand": "ГК-Пластик"
    },
]
Пример ответа XML:
<?xml version="1.0"?>
<data>
    <item0>
        <id>6357</id>
        <name>Фара головного света с указателем поворота левая Scania</name>
        <article>GK121533</article>
        <count>4</count>
        <price>5393.73</price>
        <brand>ГК-Пластик</brand>
    </item0>
</data>