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

Журнал показывает каждую доставку: когда, что ответил ваш адрес и сколько было попыток. Проверка шлёт событие ping и сразу говорит, принял ли его адрес. Право — webhooks.

Журнал

GET /webhooks/{id}/deliveries — доставки подписки, новые сверху.

curl "https://app.deskus.ru/api/v1/webhooks/c8a1f5e3-2d9b-4c6a-8e0f-7b3d1a9c5e26/deliveries?status=failed" \
  -H "Authorization: Bearer $DESKUS_KEY"

Ответ 200

{
  "data": [
    {
      "id": "2e7d0b9f-5c1a-4e3d-9b8f-6a2c4e0d1b75",
      "event_id": "message.created:e6c3a9f1-4d7b-4c2e-9f8a-3b1d5e7c0a92",
      "event_type": "message.created",
      "status": "pending",
      "attempts": 2,
      "response_status": 503,
      "response_body": "Service Unavailable",
      "error": "Ответ 503.",
      "duration_ms": 412,
      "next_attempt_at": "2026-10-21T10:05:00.000Z",
      "delivered_at": null,
      "created_at": "2026-10-21T09:44:02.118Z"
    }
  ],
  "next_cursor": null
}

Параметры: status — pending, delivered или failed; limit и cursor. Журнал хранится 30 дней.

Проверить адрес

POST /webhooks/{id}/test — тело не нужно.

curl -X POST https://app.deskus.ru/api/v1/webhooks/c8a1f5e3-2d9b-4c6a-8e0f-7b3d1a9c5e26/test \
  -H "Authorization: Bearer $DESKUS_KEY"

Ответ 200

{ "data": { "id": "2e7d0b9f-5c1a-4e3d-9b8f-6a2c4e0d1b75", "ok": true, "response_status": 200, "error": null, "duration_ms": 87 } }

На адрес уходит событие type: "ping" — ответьте 2xx. Выключенную подписку проверить нельзя — 409 conflict: сначала включите её (PATCH).