Описание
Получив и заполнив необходимые поля и парметры, из предыдущего запроса и используя список товаров для заказа, данный запрос сформирует Ваш заказ на нашем основном сайте.
Формат запроса
[apirms.ru/techapi/]?[get=set_order]&[token=ваш_токен]&[jsonData={данные_вашего_заказа}]
Параметры запроса
| Параметр | Описание |
|---|---|
| apirms.ru/techapi/ | Путь к ресурсу |
| get=set_order | Метод формирования заказа |
| token=ваш_токен | Токен пользователя |
| jsonData={данные_вашего_заказа} | Массив передаваемых параметров в фигурных скобках {}, для оформления заказа, описанных ниже и показанных на изображении |
| "payment":977 | Идентификатор способа оплаты |
| "delivery":872 | Идентификатор способа доставки |
| "address":978 или "address":"new" | Идентификатор адреса доставки. Если указано число, то поля в массиве address_new заполнять не обязательно. Если же указан параметр "new", обозначающий передачу в заказе нового адреса, то поля должны быть заполнены. |
| address_new | Массив полей нового адреса |
| "country":"Россия" | Поле - страна |
| "index":"123112" | Поле - индекс |
| "city":"Санкт-Петербург" | Поле - город |
| "street":"Невский пр." | Поле - улица |
| "house":"35" | Поле - дом |
| "flat":"" | Поле - квартира (не обязательный к заполнению, при отсутствии таковой) |
| "items" | Массив товаров для формирования заказа |
| "id":687 | Идентификатор товара |
| "amount":3 | Количество товара |
Возвращаемые данные
В случае выполнения успешного запроса, возвращается массив с двумя элементами: 'status' со значением 'successful' означающем, что запрашиваемые данные получены и 'result' в котором представлены возвращаемые данные в виде значения или массива 'items' значений, элементы которых представлены в таблице.
| Элемент | Значение |
|---|---|
| result | Заказ создан |
Возвращаемые ошибки
В случае не удачного выполнения запроса, возвращается массив с двумя элементами: 'status' со значение 'error' означающем, что запрашиваемые данные не получены и 'result' в котором представлены возвращаемые ошибки в виде массива значений, 'code' - код ошибки и 'message' - текстовое значение ошибки, данные которых представлены в таблице.
| Код | Значение |
|---|---|
| 100 | unknown error |
| 200 | token not found |
| 300 | it is necessary to transfer all obligatory parameters |
| 400 | error of definition of the user |
| 500 | error of definition of a payment method |
| 600 | error of definition of a way of delivery |
| 700 | error of definition of the address of delivery |