Надежный и креативный оптовый поставщик посуды
для сервировки и приготовления, сувениров, подарков,
предметов интерьера и текстиля.

Информация о работе с 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.products_codes_in_stock Получить все артикулы в наличии
POST
https://arti-m.ru/index.php?dispatch=api.create_order Создать новый заказ
Описание полей товара, которые запрашивает API
Поле Описание Тип Комментарий
apikey API ключ (string) Обязательное поле. Уникальный ключ для работы с API (высылается на почту)
user_id ID пользователя (int) Обязательное поле. ID вашего профиля в системе arti-m.ru (высылается на почту)
order_id ID заказа (string) Необязательное поле. Только для запроса create_order. ID заказа с вашего сайта
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)
rrp Рекомендованная розничная цена (int)
marking Маркировка (string) Значения Y/N
amount Доступное количество на складе (int) если больше 21, то всегда указывается 21
category Главная категория (string)
full_category Полное дерево категорий (string)
code Артикул (string)
packing Фасовка (характеристика) (string) Пример - "Фасовка: 1/1"
serie Серия (характеристика) (string) Пример - "Натюрморт"
type Тип (характеристика) (string) Пример - "Полотенца для кухни"
brand Бренд (характеристика) (string) Пример - "SANTALINO"
country Страна (характеристика) (string) Пример - "Россия"
manufactory Производитель (характеристика) (string)
material Материал (характеристика) (string) Пример - "Хлопок"
size Размер (характеристика) (string) Пример - "10,2х10,2х12,2 см"
volume Объём (характеристика) (string) Пример - "0,9 л"
diameter Диаметр (характеристика) (string) Пример - "10,2 см"
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) только для запроса на создание заказа
total_count Общее количество товаров (int) только для запросов products и products_part
codes_zero_amount Список артикулов товаров, которые не были в наличии на момент запроса (array) только для запроса на создание заказа
codes_failed_products Список артикулов товаров, которые нет в системе (array) только для запрос на создание заказа
Возможные ошибки при подключении по API
Ошибка Описание
apikey отсутствует В запросе во входных параметрах было пропущено поле apikey. Напишите нам на почту web@arti-m.com для получения apikey
user_id отсутствует В запросе во входных параметрах было пропущено поле user_id. Напишите нам на почту web@arti-m.com для получения user_id
apikey не верен В запросе во входных параметрах был указан не верный apikey или user_id. Возможно у Вашего аккаунта не включена возможность подключения по API.