Подписка на вебхуки (Webhooks)
Методы предназначены для управления подпиской на получение вебхуков на URL клиента.
Так как тестовый аккаунт СДЭК является общим для всех клиентов, для тестирования вебхуков необходимо использовать только боевой URL СДЭК. |
1. Добавление подписки
Метод предназначен для добавления подписки на получение вебхуков.
На текущий момент есть возможность добавить подписку на события по статусам заказа и по готовности печатной формы.
Запрос на добавление подписки
Для использования необходимо отправить POST-запрос на URL: https://api.cdek.ru/v2/webhooks
Тело запроса необходимо передавать в формате JSON (Content-Type: application/json).
Поддерживаются следующие поля:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | url | URL, на который клиент хочет получать вебхуки | string() | да |
2 | type1 | Тип события: | string() | да |
1 Если у клиента уже есть подписка с указанным типом, то старый url перезатирается на новый
Ответ на добавление подписки
Ответ возвращается в формате JSON:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | entity | Информация о подписке | entity | нет |
1.1 | uuid | Идентификатор подписки в ИС СДЭК | UUID | нет |
2 | requests | Информация о запросе над подпиской | request[] | да |
2.1 | request_uuid | Идентификатор запроса в ИС СДЭК | UUID | нет |
2.2 | type | Тип запроса Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET | string() | да |
2.3 | date_time | Дата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2.4 | state | Текущее состояние запроса ACCEPTED - пройдена предварительная валидация и запрос принят | string() | да |
2.5 | errors | Ошибки, возникшие в ходе выполнения запроса | error[] | нет |
2.5.1 | code | Код ошибки | string() | да |
2.5.2 | message | Описание ошибки | string() | да |
2.6 | warnings | Предупреждения, возникшие в ходе выполнения запроса | warning[] | нет |
2.6.1 | code | Код предупреждения | string() | да |
2.6.2 | message | Описание предупреждения | string() | да |
{ "url":"https://webhook.site", "type":"ORDER_STATUS" } |
{ "entity": { "uuid": "73c65d02-51a9-4423-8ee8-cc662ec3eb85" }, "requests": [ { "request_uuid": "72753031-0e1b-4f1d-abcc-b0bb0bd6ab2f", "type": "CREATE", "state": "SUCCESSFUL", "date_time": "2020-02-10T12:14:57+0700", "errors": [], "warnings": [] } ] } |
2. Информация о подписке
Метод предназначен для получения информации о подписке/подписках клиента на получение вебхуков.
Запрос на получение информации о подписке
Для использования необходимо отправить GET-запрос на URL:
- информация о подписке: https://api.cdek.ru/v2/webhooks/{uuid}, где uuid - идентификатор подписки
- информация о всех текущих подписках: https://api.cdek.ru/v2/webhooks
Ответ на получение информации о подписке
Ответ возвращается в формате JSON:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | entity | Информация о подписке | entity | нет |
1.1 | uuid | Идентификатор подписки | UUID | да |
1.2 | url | URL, на который клиенту приходят вебхуки | string() | да |
1.3 | type | Тип события | string() | да |
2 | requests | Информация о запросе над подпиской | request[] | да |
2.1 | request_uuid | Идентификатор запроса в ИС СДЭК | UUID | нет |
2.2 | type | Тип запроса Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET | string() | да |
2.3 | date_time | Дата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2.4 | state | Текущее состояние запроса ACCEPTED - пройдена предварительная валидация и запрос принят | string() | да |
2.5 | errors | Ошибки, возникшие в ходе выполнения запроса | error[] | нет |
2.5.1 | code | Код ошибки | string() | да |
2.5.2 | message | Описание ошибки | string() | да |
2.6 | warnings | Предупреждения, возникшие в ходе выполнения запроса | warning[] | нет |
2.6.1 | code | Код предупреждения | string() | да |
2.6.2 | message | Описание предупреждения | string() | да |
https://api.cdek.ru/v2/webhooks/73c65d02-51a9-4423-8ee8-cc662ec3eb85 |
{ "entity": { "uuid": "73c65d02-51a9-4423-8ee8-cc662ec3eb85", "type": "ORDER_STATUS", "url": "https://webhook.site" }, "requests": [ { "request_uuid": "72753031-5ae3-448f-ba78-ea29d08e89fa", "type": "CREATE", "state": "SUCCESSFUL", "date_time": "2020-02-10T12:17:06+0700", "errors": [], "warnings": [] } ] } |
3. Удаление подписки
Метод предназначен для удаления подписки на получение вебхуков.
Запрос на удаление подписки
Для использования необходимо отправить DELETE-запрос на URL:
https://api.cdek.ru/v2/webhooks/{uuid}, где uuid - идентификатор подписки
Ответ на удаление подписки
Ответ возвращается в формате JSON:
№ | Название поля | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | entity | Информация о подписке | entity | нет |
1.1 | uuid | Идентификатор удаленной подписки | UUID | да |
2 | requests | Информация о запросе над подпиской | request[] | да |
2.1 | request_uuid | Идентификатор запроса в ИС СДЭК | UUID | нет |
2.2 | type | Тип запроса Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET | string() | да |
2.3 | date_time | Дата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2.4 | state | Текущее состояние запроса ACCEPTED - пройдена предварительная валидация и запрос принят | string() | да |
2.5 | errors | Ошибки, возникшие в ходе выполнения запроса | error[] | нет |
2.5.1 | code | Код ошибки | string() | да |
2.5.2 | message | Описание ошибки | string() | да |
2.6 | warnings | Предупреждения, возникшие в ходе выполнения запроса | warning[] | нет |
2.6.1 | code | Код предупреждения | string() | да |
2.6.2 | message | Описание предупреждения | string() | да |
https://api.cdek.ru/v2/webhooks/73c65d02-51a9-4423-8ee8-cc662ec3eb85 |
{ "entity": { "uuid": "73c65d02-51a9-4423-8ee8-cc662ec3eb85" }, "requests": [ { "request_uuid": "72753031-0e1b-4f1d-abcc-b0bqw456ab2f", "type": "DELETE", "state": "SUCCESSFUL", "date_time": "2020-02-10T12:14:57+0700", "errors": [], "warnings": [] } ] } |
© 2000—2022, Курьерская компания СДЭК