Получение вебхука по уникальному идентификатору

Получает вебхук по уникальному идентификатору.

Request

GET

https://api.kit.yandex.net/v1/webhooks/{webhook_id}

Responses

200 OK

Вебхук

Body

application/json
{
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "url": "https://example.com/webhook",
  "events": [
    "ORDER_STATUS_CHANGED"
  ],
  "status": "ACTIVE"
}

Name

Description

events

Type: WebhookEventTypes[]

Список типов событий, на которые подписан вебхук.

Example
[
  "ORDER_STATUS_CHANGED"
]

id

Type: WebhookID

ID вебхука.

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

status

Type: WebhookStatus

Статус вебхука:

  • ACTIVE — активный.
  • INACTIVE — неактивный.

Enum: ACTIVE, INACTIVE

url

Type: string

URL вебхука.

Example: https://example.com/webhook

WebhookID

ID вебхука.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

WebhookEventTypes

Тип события:

  • ORDER_STATUS_CHANGED — изменился статус заказа.
  • ORDER_PAYMENT_STATUS_CHANGED — изменился статус оплаты заказа.
  • ORDER_DELIVERY_STATUS_CHANGED — изменился статус доставки заказа.

Type: string

Enum: ORDER_STATUS_CHANGED, ORDER_PAYMENT_STATUS_CHANGED, ORDER_DELIVERY_STATUS_CHANGED

WebhookStatus

Статус вебхука:

  • ACTIVE — активный.
  • INACTIVE — неактивный.

Type: string

Enum: ACTIVE, INACTIVE

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

404 Not Found

Ресурс не найден.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000