PlatitunPlatitun · API · Сделка · Задать режим работы
Задать режим работы
PUT /api/v1/work-modeОбласть ключа: orders · изменяет данные, нужен заголовок Idempotency-Key
Вместимость, «не беспокоить» и тихие часы задаются программой. Часы — в UTC, как всё время площадки; переводить их в местное время сервера запрещено.
Тихие часы задаются оба или ни один: один заданный час означает промежуток без конца — из него не выйти, и тишина стала бы вечной.
Поля запроса
| Поле | Тип | Что это |
|---|---|---|
capacity обязательно | integer | Сколько заказов брать одновременно, от 1 до 50. |
doNotDisturb | boolean | Просьба не звать. |
quietFromHour | integer | Начало тихих часов, UTC, 0–23. |
quietToHour | integer | Конец тихих часов, UTC, 0–23. |
Поля ответа
| Поле | Тип | Что это |
|---|---|---|
capacity | integer | Что стало. |
Поводы отказа
Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.
| Код | Что случилось и что делать |
|---|---|
capacity_bad | Вместимость вне допустимых границ. |
quiet_hours_bad | Тихие часы задаются оба или ни один, и они не должны совпадать: один заданный час означал бы промежуток без конца. |
Рядом в этом разделе
GET /api/v1/orders— Свои заказыGET /api/v1/orders/{id}— Один заказPOST /api/v1/orders/{id}/confirm— Взять заказPOST /api/v1/orders/{id}/decline— Отказаться от заказаPOST /api/v1/orders/{id}/deliver— Отметить выдачуPOST /api/v1/orders/{id}/messages— Написать покупателюGET /api/v1/orders/{id}/handover— Сейфы заказаPOST /api/v1/orders/{id}/handover— Положить доступ в сейфPOST /api/v1/orders/{id}/handover/reveal— Прочитать сейф покупателяPOST /api/v1/orders/{id}/dispute/reply— Ответить в спореGET /api/v1/reviews— Отзывы о себеPOST /api/v1/reviews/{id}/reply— Ответить на отзывGET /api/v1/complaints— Свои жалобыPOST /api/v1/complaints— Пожаловаться на покупателяGET /api/v1/work-mode— Режим работы и присутствие