Оптовая компания по продаже посуды, сувениров,
подарков, предметов интерьера и текстиля
Регион: Москва

Информация о работе с API

Общая информация о работе с API

API arti-m.ru предоставляет доступ к следующим функциям: получение товаров по артикулам, получение товаров по артикулам с возможностью выбора нужных полей, получение всех товаров, получение всех товаров с возможностью выбора нужных полей и создание нового заказа.

Для работы с API вам необходимо получить APIKEY. Он выдаётся только зарегистрированным пользователям. Напишите нам на почту web@arti-m.com, чтобы мы выслали Вам APIKEY.

Для одного из запросов Вам могут быть нужны артикулы товары. Вы можете получить список нужных Вам артикулов на этой странице.

Для получения данных можно использовать программу Advanced Rest Client или аналогичную.

Обратите внимание! Если Вы получаете все товары, которые есть в наличии, то запрос может выполняться в течении 5-7 минут.

Запросы
POST
https://arti-m.ru/index.php?dispatch=api.products_by_code Получить товары по артикулу
POST
https://arti-m.ru/index.php?dispatch=api.products_by_code_part Получить товары c нужными полями по артикулам
POST
https://arti-m.ru/index.php?dispatch=api.products Получить все товары
POST
https://arti-m.ru/index.php?dispatch=api.products_part Получить все товары c нужными полями
POST
https://arti-m.ru/index.php?dispatch=api.create_order Создать новый заказ
Описание полей товара, которые запрашивает API
Поле Описание Тип Комментарий
apikey API ключ (string) Обязательное поле. Уникальный ключ для работы с API (высылается на почту)
user_id ID пользователя (int) Обязательное поле. ID вашего профиля в системе arti-m.ru (высылается на почту)
product_codes Артикулы (array) Обязательное поле только для запросово с артикулами. Массив артикулов товаров. В запросе с созданием заказа в массиве нужно также указывать количество товара. Только для запросов products_by_code, products_by_code_part, create_order, products_images
limit Ограничение товаров (int) Не обязательное поле. Количество товаров, которые Вы хотите получить. Если указывать этот параметр, то запрос по получению товаров будет проходить гораздо быстрее. Если этот параметр установлен, то параметры page и items_per_page будут игнорироваться. Только для запросов products и products_part
page Итерация порции (int) Не обязательное поле. Только для запросов products и products_part
items_per_page Ограничение товаров (int) Не обязательное поле. Количество товаров, которые будет в одной итерации(page). Только для запросов products и products_part
Описание полей товара, которые возвращает API
Поле Описание Тип Комментарий
name название (string)
description тектсовое описание (string)
barcode штрих-код (string)
price цена (int)
amount Доступное количество на складе (int) если больше 21, то всегда указывается 21
category Главная категория (string)
full_category Полное дерево категорий (string)
code артикул (string)
packing фасовка (характеристика) (string)
serie серия (характеристика) (string)
type тип (характеристика) (string)
brand бренд (характеристика) (string)
size размер (характеристика) (string)
images изображения (главное + дополнительные) (array)
min_qty Минимальное количество (int)
max_discount Максимально возможная скидка (int) измеряется в %. Если равно 0, то скидка не предусмотрена, если 100, то любая скидка возможна
weight Вес (характеристика) (int) измеряется в КГ
box_length Длина коробки (характеристика) (int) измеряется в СМ
box_width Ширина коробки (характеристика) (int) измеряется в СМ
box_height Высота коробки (характеристика) (int) измеряется в СМ
status Статус запроса (boolean) только для запроса на создание заказа
status_text Текстовое описание статуса запроса (string) только для запроса на создание заказа
codes_zero_amount Список ID товаров, которые не были в наличии на момент запроса (array) только для запроса на создание заказа
Возможные ошибки при подключении по API
Ошибка Описание
apikey отсутствует В запросе во входных параметрах было пропущено поле apikey. Напишите нам на почту web@arti-m.com для получения apikey
user_id отсутствует В запросе во входных параметрах было пропущено поле user_id. Напишите нам на почту web@arti-m.com для получения user_id
apikey не верен В запросе во входных параметрах был указан не верный apikey или user_id. Возможно у Вашего аккаунта не включена возможность подключения по API.