Получение вебхука
Скачать OpenAPIАвторизация
api_key Передаётся в: query
Параметры пути
ID вебхука
uuidТело ответа
application/json
curl -X GET "https://example.com/v2/webhooks/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"{ "success": true, "data": { "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "callback_url": "https://example.com/webhooks/cargotime", "is_active": true, "event_types": [ "tracking.eta_update", "tracking.history_update", "tracking.info_found", "tracking.info_not_found", "tracking.auto_archiving", "tracking.delivered" ], "created_at": "2026-07-08T09:39:36.311Z", "updated_at": "2026-07-08T13:10:43.554Z" }, "status": "OK", "status_description": "Запрос выполнен успешно"}Создание вебхука POST
Создаёт вебхук для вашего аккаунта. В ответе вы получите `secret` для проверки подписи (22 символа из алфавита base64url: A–Z, a–z, 0–9, `-`, `_`). Секрет показывается только в этом ответе и не возвращается при последующем чтении вебхука, поэтому сразу сохраните его в безопасном месте. При каждой доставке Cargotime отправляет `POST`-запрос на ваш `callback_url`. Запрос содержит JSON-объект `WebhookOutgoingPayload` и заголовки: - `x-cargotime-signature` — HMAC SHA-256-подпись строки `timestamp + '.' + rawBody` с префиксом `sha256=`; - `x-cargotime-timestamp` — метка времени Unix, использованная для подписи; - `x-cargotime-event-id` — уникальный идентификатор события, совпадающий с `payload.id`; - `x-cargotime-delivery-id` — уникальный идентификатор попытки доставки.
Обновление вебхука PATCH
Изменяет `callback_url`, статус вебхука и список событий. При `regenerate_secret=true` ответ содержит новый `secret`. Он показывается только в этом ответе и не возвращается при последующем чтении вебхука.