Вебхуки

Эндпоинты вебхуков Slicer API — добавить адрес и получить секрет подписи, изменить, удалить, отправить проверочное событие и посмотреть журнал доставок.

На этой странице

Добавить вебхук
Список вебхуков
Вебхук
Изменить вебхук
Удалить вебхук
Отправить проверочное событие `ping`
Последние 100 доставок
Схемы

Вебхуки сообщают вашему серверу о событиях: готова загрузка, закончился монтаж или экспорт, опубликован ролик. Нужна область webhooks. Формат событий, подпись и её проверка — в руководстве Вебхуки.

Добавить вебхук

POST/v1/webhooks

Области доступа: webhooks
Лимит: обычный

Тело запроса `CreateWebhookRequest`

Поле	Тип	Описание
`url`обязательное	`string (uri)`	≤ 2048
`events`обязательное	`string[]`
`description`	`string`	≤ 200

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/webhooks" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hook","events":["upload.ready"]}'

const response = await fetch('https://api.slicer.media/v1/webhooks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://example.com/hook",
    "events": [
      "upload.ready"
    ]
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/webhooks",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "url": "https://example.com/hook",
        "events": ["upload.ready"],
    },
)
body = response.json()

Ответ

Поля ответа: CreatedWebhook (2)

Поле	Тип	Описание
`webhook`обязательное	`Webhook`
`secret`обязательное	`string`	Секрет подписи `whsec_…` — показывается один раз

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

{
  "ok": true,
  "data": {
    "webhook": {
      "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
      "url": "https://example.com/hook",
      "events": [
        "upload.ready"
      ],
      "description": "string",
      "enabled": true,
      "disabledReason": "string",
      "failures": 1,
      "lastDeliveryAt": "2026-10-16T09:30:00Z",
      "createdAt": "2026-10-16T09:30:00Z"
    },
    "secret": "whsec_…"
  }
}

Список вебхуков

GET/v1/webhooks

Области доступа: webhooks
Лимит: обычный

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/webhooks" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/webhooks', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/webhooks",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

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

{
  "ok": true,
  "data": [
    {
      "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
      "url": "https://example.com/hook",
      "events": [
        "upload.ready"
      ],
      "description": "string",
      "enabled": true,
      "disabledReason": "string",
      "failures": 1,
      "lastDeliveryAt": "2026-10-16T09:30:00Z",
      "createdAt": "2026-10-16T09:30:00Z"
    }
  ]
}

Вебхук

GET/v1/webhooks/{id}

Области доступа: webhooks
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: Webhook (9)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`url`обязательное	`string (uri)`
`events`обязательное	`string[]`
`description`обязательное	`string \| null`
`enabled`обязательное	`boolean`
`disabledReason`обязательное	`string \| null`
`failures`обязательное	`integer`	Неудачных доставок подряд
`lastDeliveryAt`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

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

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "url": "https://example.com/hook",
    "events": [
      "upload.ready"
    ],
    "description": "string",
    "enabled": true,
    "disabledReason": "string",
    "failures": 1,
    "lastDeliveryAt": "2026-10-16T09:30:00Z",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Изменить вебхук

PATCH/v1/webhooks/{id}

Области доступа: webhooks
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Тело запроса `UpdateWebhookRequest`

Поле	Тип	Описание
`url`	`string (uri)`	≤ 2048
`events`	`string[]`
`description`	`string \| null`	≤ 200
`enabled`	`boolean`

Запрос

curl

JavaScript

Python

curl -X PATCH "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hook","events":["upload.ready"]}'

const response = await fetch('https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://example.com/hook",
    "events": [
      "upload.ready"
    ]
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.patch(
    "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "url": "https://example.com/hook",
        "events": ["upload.ready"],
    },
)
body = response.json()

Ответ

Поля ответа: Webhook (9)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`url`обязательное	`string (uri)`
`events`обязательное	`string[]`
`description`обязательное	`string \| null`
`enabled`обязательное	`boolean`
`disabledReason`обязательное	`string \| null`
`failures`обязательное	`integer`	Неудачных доставок подряд
`lastDeliveryAt`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

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

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "url": "https://example.com/hook",
    "events": [
      "upload.ready"
    ],
    "description": "string",
    "enabled": true,
    "disabledReason": "string",
    "failures": 1,
    "lastDeliveryAt": "2026-10-16T09:30:00Z",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Удалить вебхук

DELETE/v1/webhooks/{id}

Области доступа: webhooks
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl -X DELETE "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.delete(
    "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: object (2)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`deleted`обязательное	`boolean`

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

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "deleted": true
  }
}

Отправить проверочное событие `ping`

POST/v1/webhooks/{id}/test

Области доступа: webhooks
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/test" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/test', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/test",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: WebhookDelivery (9)

Поле	Тип	Описание
`id`обязательное	`integer`
`eventId`обязательное	`string`
`type`обязательное	`string`
`status`обязательное	`string`	`pending` · `succeeded` · `failed`
`attempts`обязательное	`integer`
`responseStatus`обязательное	`integer \| null`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC
`deliveredAt`обязательное	`string \| null`

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

{
  "ok": true,
  "data": {
    "id": 42,
    "eventId": "string",
    "type": "string",
    "status": "pending",
    "attempts": 1,
    "responseStatus": 1,
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z",
    "deliveredAt": "2026-10-16T09:30:00Z"
  }
}

Последние 100 доставок

GET/v1/webhooks/{id}/deliveries

Области доступа: webhooks
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/deliveries" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/deliveries', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/webhooks/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/deliveries",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

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

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "eventId": "string",
      "type": "string",
      "status": "pending",
      "attempts": 1,
      "responseStatus": 1,
      "error": "string",
      "createdAt": "2026-10-16T09:30:00Z",
      "deliveredAt": "2026-10-16T09:30:00Z"
    }
  ]
}

Схемы

Webhook

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`url`обязательное	`string (uri)`
`events`обязательное	`string[]`
`description`обязательное	`string \| null`
`enabled`обязательное	`boolean`
`disabledReason`обязательное	`string \| null`
`failures`обязательное	`integer`	Неудачных доставок подряд
`lastDeliveryAt`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

CreatedWebhook

Поле	Тип	Описание
`webhook`обязательное	`Webhook`
`secret`обязательное	`string`	Секрет подписи `whsec_…` — показывается один раз

WebhookDelivery

Поле	Тип	Описание
`id`обязательное	`integer`
`eventId`обязательное	`string`
`type`обязательное	`string`
`status`обязательное	`string`	`pending` · `succeeded` · `failed`
`attempts`обязательное	`integer`
`responseStatus`обязательное	`integer \| null`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC
`deliveredAt`обязательное	`string \| null`

Добавить вебхук#

Тело запроса CreateWebhookRequest

Запрос

Ответ

Список вебхуков#

Запрос

Ответ

Вебхук#

Параметры пути

Запрос

Ответ

Изменить вебхук#

Параметры пути

Тело запроса UpdateWebhookRequest

Запрос

Ответ

Удалить вебхук#

Параметры пути

Запрос

Ответ

Отправить проверочное событие `ping`#

Параметры пути

Запрос

Ответ

Последние 100 доставок#

Параметры пути

Запрос

Ответ

Схемы#

Добавить вебхук

Тело запроса `CreateWebhookRequest`

Список вебхуков

Вебхук

Изменить вебхук

Тело запроса `UpdateWebhookRequest`

Удалить вебхук

Отправить проверочное событие `ping`

Последние 100 доставок

Схемы