Получить событие Webhook

GET

/api/v1/webhook/events/{event_id}

Для пользователей из материкового Китая: используйте https://api.toapis.cn в качестве эндпоинта (Base URL). Замените https://api.toapis.com на https://api.toapis.cn во всех примерах этого документа.

Поведение

Возвращает свежее состояние одного события доставки и ход повторов: состояние, число попыток, последний HTTP-статус, замаскированный reason, метки RFC 3339.

Payload события, адрес обратного вызова, сырой ответ приёмника, данные worker, выполнявшего доставку, и полный журнал всех попыток не возвращаются. События других аккаунтов или несуществующие — 404.

Аутентификация

Authorizationstringзаголовокобязательно

Используйте системный токен Bearer YOUR_SYSTEM_ACCESS_TOKEN. Доступ ограничен вашим аккаунтом. Ключи моделей не принимаются. X-User-Id не нужен. Обхода через права администратора или команды нет.

Параметры запроса

event_idstringпутьобязательно

ID события.

Отсутствующий event_id или принадлежащий другому аккаунту — 404; при лимите — 429.

Примеры запросов

Пример запроса

curl --request GET \
  --url 'https://api.toapis.com/api/v1/webhook/events/evt_example' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

Примеры ответов

Пример ответа

{
  "code": 0,
  "message": "",
  "data": {
    "event_id": "evt_example",
    "api_key_id": 123,
    "task_id": "example-task",
    "type": "generation.completed",
    "status": "delivered",
    "attempts": 1,
    "reason": "delivered",
    "last_http_status": 200,
    "created_at": "2026-11-13T00:00:00Z",
    "next_attempt_at": null,
    "delivered_at": "2026-11-13T00:00:01Z",
    "expires_at": "2026-11-14T12:00:00Z"
  }
}

Порядок подключения и проверку подписи см. в Получить настройки Webhook.