Platitun · API · Подписка на события · Журнал доставки

Журнал доставки

GET /api/v1/hooks/deliveries

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

Здесь ответ на спор «вы мне не присылали» — «мы присылали»: событие, время, число попыток, код ответа вашего приёмника и текст ошибки. Одна запись на событие, а не на попытку.

Состояние skipped_paused означает событие, случившееся при остановленной доставке. Оно записано намеренно: тишина скрыла бы от вас, чего именно вы не получили.

Отбор в адресе

Поле	Тип	Что это
`limit`	`integer`	Сколько записей вернуть. Умолчание 50, предел 200.
`cursor`	`string`	Значение nextCursor из прошлого ответа. Номеров страниц нет: пока листаешь, список меняется.

Поля ответа

Поле	Тип	Что это
`items`	`array`	Записи страницы.
`items[].event`	`string`	Какое событие.
`items[].status`	`string`	pending, delivered, given_up или skipped_paused.
`items[].attempt`	`integer`	Какая попытка идёт или на какой остановились.
`items[].httpStatus`	`integer\|null`	Что ответил ваш приёмник.
`items[].error`	`string\|null`	Что именно не вышло.
`items[].nextAttemptAt`	`string\|null`	Когда будет следующая попытка.
`nextCursor`	`string\|null`	Курсор следующей страницы. Пусто — страница последняя.

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

GET /api/v1/hooks — Своя подписка на события
PUT /api/v1/hooks — Задать адрес и события
DELETE /api/v1/hooks — Отключить доставку
POST /api/v1/hooks/secret — Заменить секрет подписи
POST /api/v1/hooks/resume — Включить доставку снова
POST /api/v1/hooks/test — Пробное событие
POST /api/v1/hooks/probe — Выдать адрес служебного приёмника
GET /api/v1/hooks/probe — Что принял служебный приёмник