Platitun · API · Сделка · Один заказ

Один заказ

GET /api/v1/orders/{id}

Область ключа: orders · только чтение

Заказ целиком: состояние, сроки, слепок услуги на момент покупки, переписка и сейфы. Слепок нужен, чтобы спор через месяц разбирался по тому, что покупатель видел, а не по нынешней карточке.

Поля ответа

Поле	Тип	Что это
`number`	`integer`	Публичный номер заказа: его называет человек в поддержке и в переписке.
`status`	`string`	Состояние заказа.
`snapshot`	`object`	Слепок услуги: название, план, срок выдачи, гарантия.
`messages`	`array`	Переписка: кто, когда, что. Последние двести сообщений.
`handovers`	`array`	Сейфы заказа, заведённые до 09.09.2026: чей и открывали ли. Секретов здесь нет. Сейф отключён, у новых заказов список пуст.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.

Рядом в этом разделе

GET /api/v1/orders — Свои заказы
POST /api/v1/orders/{id}/confirm — Взять заказ
POST /api/v1/orders/{id}/decline — Отказаться от заказа
POST /api/v1/orders/{id}/deliver — Отметить выдачу
POST /api/v1/orders/{id}/messages — Написать покупателю
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 — Режим работы и присутствие
PUT /api/v1/work-mode — Задать режим работы