Быстрый старт
Полный цикл выполнения заказа - пять вызовов API.
Этот сценарий выполняет один заказ от начала до конца. Сначала получите API-ключ магазина - см. Авторизацию - им аутентифицируется каждый запрос.
Каждый шаг ведёт на полную страницу справочника: параметры, схема запроса/ответа, примеры и интерактивный playground «Try it».
1. Что можно автоматизировать
Список товаров магазина с включённой внешней автоматизацией.
2. Опрос новых заказов
Новые (оплаченные, ещё не взятые) заказы по этим товарам. В каждом заказе
введённые покупателем значения лежат в fieldValues - всё нужное для выполнения.
3. Взять заказ в работу
Перевод в processing; исполнитель фиксируется как api.
4. Написать покупателю (опционально)
Сообщение в чат заказа от имени магазина.
5. Выдать результат
Отметить заказ выполненным и (опционально) приложить выданное значение, которое
увидит покупатель. Заказ переходит в awaiting_confirmation; деньги поступают
магазину после того, как покупатель подтвердит получение.
Отметить выполненным
POST /orders/{id}/deliver
Отменить заказ
POST /orders/{id}/cancel - возврат средств и откат.
Идемпотентность
take, deliver и cancel принимают заголовок Idempotency-Key. Повтор с
тем же ключом вернёт прежний результат вместо повторного действия - безопасно
для сетевых ретраев.