API - автоматизированное размещение заказов.

Запросы могут отправляться по протоколу HTTP методом GET или POST.

Формат запроса:

http://stripmag.ru/api/order.php?ApiKey=****&TestMode=*&RollBack=*&order=11111111-1,22222222-1

Параметры запроса:
  • ApiKey - все запросы должны содержать ApiKey. Этот параметр идентифицирует Вас у нас в система и по нему мы понимаем от кого пришел запрос. Узнать Ваш ApiKey Вы можете в Вашем личном кабинете - API и выгрузки.
  • TestMode - не обязательный параметр. Может принимать значения 0 и 1. Если параметр имеет значение 1, т.е. тестовый режим включен, то запросы принимаются, данные проверяются и выдается ответ о валидности данных, но сам заказ не размещается. По умолчанию этот параметр равен 0.
  • RollBack - не обязательный параметр. Может принимать значения 1 и 2. Параметр указывает системе - что делать в случае если не все запрашиваемые позиции найдены, или например какой-то из позиций не достаточное количество.
    Если параметр имеет значение 1, то система разместит заказ в любом случае. Не найденный товары будут проигнорированы. А товары количество, которых меньше нужного, будут добавлены в заказ в том количестве в каком они есть на складе.
    Если параметр имеет значение 2, то система разместит заказ только, если найдены все запрашиваемые позиции, и все товары есть достаточном для заказа количестве.
    По умолчанию этот параметр равен 1.
  • order - это обязательный параметр. Он содержит содержать пары вида: <aID>-<qty>. Пары отделяются друг от друга запятыми.
    aID - это идентификатор товарного предложения. Более подробно - что такое aID?
    qty - количество товара которое нужно добавить в заказ.

Результаты работы.

По результатам работы система выдает структурированный ответ в формате XML.

Поле Status - говорит о результате выполнения запроса. Может принимать следующие значения:

  • 1 - "Ok", Запрос выполнен успешно. Заказ размещен.
  • 2 - "Bad key", Проверьте корректность Вашего ApiKey.
  • 3 - "Bad order request", Не корректные данные в поле order.
  • 4 - "Order do not placed. Some items not at stock OR some problem in aID.", Заказ не размещен, Либо каких-то товаров недостаточное количество на нашем складе, либо какие-то aID не найдены в нашей системе.
  • 5 - "TestMode. Data was checked. Order have NOT placed.". Включен тестовый режим. Данные проверены, но заказ не размещается.

В случае возникновения ошибок приводится подробная диагностика по каждой проблемной паре <aID>-<qty>.

Если заказ размещен, в ответе будет приведен номер размещенного заказа и его состав.

Заказы размещаются с учетом Вашей клиентской скидки.

Если у Вашего программиста будут вопросы/предложения пусть он свяжется c нами, мы обязательно Вам поможем.

Данный сайт может содержать материалы для взрослых.

Чтобы продолжить, подтвердите, что вам уже исполнилось 18 лет.
Покинуть сайт Да, мне есть 18