Platitun · API · Сделка · Прочитать сейф покупателя

Прочитать сейф покупателя

POST /api/v1/orders/{id}/handover/reveal

Область ключа: orders · изменяет данные, нужен заголовок Idempotency-Key

Покупатель тоже кладёт в сейф — например, почту, на которую оформлять подписку. Прочитать чужой сейф можно РОВНО ОДИН раз: повтор честно ответит «уже открыт». Свой сейф прочитать нельзя вовсе.

Прочитали — сохраните у себя. Второго раза не будет, и площадка не сможет его повторить: она содержимого не знает.

Поля запроса

Поле	Тип	Что это
`handover` обязательно	`string`	Номер сейфа из списка сейфов заказа.

Поля ответа

Поле	Тип	Что это
`secret`	`string`	Содержимое — в первый и последний раз.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`vault_empty`	Сейф уже открывали или он пуст. Прочитать чужой сейф можно ровно один раз, и повтор честно об этом говорит.
`vault_off`	Сейф площадки не настроен, и хранить секреты негде. Это наша беда, а не ваша: напишите в поддержку.

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

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}/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 — Задать режим работы