Rutube PartnerAPI — набор методов, позволяющий вам организовать загрузку видео на платформу Rutube из своей системы.
Свяжитесь со своим менеджером Rutube для получения client_id и client_secret партнёра.
Для работы с персонализированным контентом, загрузки и редактирования видео необходима аутентификация и авторизация на основе JWT. JWT можно получить при помощи API авторизации.
/api/v3/clients/auth/code и credentials client_id и client_secret, которые вы получили у вашего менеджера Rutube, выполните запрос одноразового code партнёра.code используйте вместе с логином и паролем от канала для вызова метода получения JWT /api/v3/clients/auth/login. В ответе вы получите пару access_token/refresh_token канала. access_token для обращения к API загрузки/управления видео.access_token используйте метод /api/v3/accounts/token и refresh_token для обновления пары токенов. Повторно авторизовываться с помощью client_id и client_secret не требуется./api/video/category/Тело запроса
| client_id | string Идентификатор партнера |
| client_secret | string Секретный ключ партнера |
{- "client_id": "string",
- "client_secret": "string"
}{- "code": "c4a4ae45-7e10-4743-b54c-d7599f260ea1"
}Тело запроса
| login | string Почта или телефон |
| password | string Пароль от аккаунта |
| code | string Одноразовый код авторизации |
{- "login": "string",
- "password": "string",
- "code": "string"
}{- "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJydXBhc3NfaWQiOjIxNTgzMTUwLCeweqweqweDg0OTkxMDYsInJlcXVlc3RfaWQiOiIzMDllMTc0NC1hNTllLTQxYW4NzIwNGRkMzgifQ.YHaGt74VC7g5noUgJB2BGtMxE8kr4ENR4kBqJUxkaiU",
- "expires_in": 1209600,
- "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJydXBhc3NfaWQiOjIxNTgzMTUwLCJleHAiOjE3ODg0OTkxMDYsInJlcXVlc3RfaWQiOiIzMDllMTc0NC1hNTllLTQxYW4NzIwNGRkMzgifQ.YHaGt74VC7g5noUgJB2BGtMxE8kr4ENR4kBqJUxkaiU"
}| refreshToken | string Рефреш-токен в куках, обязательно если нет в теле запроса |
Тело запроса
| refresh_token | string Рефреш-токен в теле запроса, обязательно если нет в куках |
{- "refresh_token": "string"
}{- "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJydXBhc3NfaWQiOjIxNTgzMTUwLCeweqweqweDg0OTkxMDYsInJlcXVlc3RfaWQiOiIzMDllMTc0NC1hNTllLTQxYW4NzIwNGRkMzgifQ.YHaGt74VC7g5noUgJB2BGtMxE8kr4ENR4kBqJUxkaiU",
- "expires_in": 1209600,
- "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJydXBhc3NfaWQiOjIxNTgzMTUwLCJleHAiOjE3ODg0OTkxMDYsInJlcXVlc3RfaWQiOiIzMDllMTc0NC1hNTllLTQxYW4NzIwNGRkMzgifQ.YHaGt74VC7g5noUgJB2BGtMxE8kr4ENR4kBqJUxkaiU",
- "is_grace_case": true
}[- {
- "id": "78",
- "related_showcase": null,
- "update_ts": "2019-08-24T14:15:22Z",
- "name": "Обзоры и распаковки товаров",
- "short_name": "goods",
- "for_kids": false,
- "for_import": true
}
]| author | integer ID канала, в который загружается видео. При отсутствии поля id канала берется из авторизационного токе на в запросе |
| url required | string Абсолютный URL для загрузки видео формата http, https, ftp на внешнее хранилище, где расположен загружаемый ролик. Ролик должен быть доступен для загрузки сервисам Rutube, и добавьте, если это необходимо, элементы авторизации в ссылку |
| callback_url | string URL для уведомления о завершении загрузки |
| errback_url | string URL для уведомления об ошибке загрузки |
| moder_callback_url | string URL для уведомления модератора после загрузки |
| query_fields | Array of strings Поля для запроса данных о видео в формате JSON. Поля, которые должны быть переданы в callback_url. Задаются в виде json-массива. Пример: query_fields=["id", "description"]. Если не указано - будут переданы все. |
| extra | string Дополнительные данные в формате JSON для callback/errback. Поля, которые как есть будут добавляться к ответу, приходящему на callback_url или errback_url. Задаются в виде json строки. В callback или errback все поля, переданные в extra, будут находится в поле "session" |
| quality_report | boolean Флаг для включения отчёта о качестве видео. Если задано, то уведомление на callback будет приходить по готовности каждого качества, а не единожды по доступности видео. |
| title | string Default: "Без названия" Название видео до 100 символов |
| description | string Ваше описание этого видео до 5000 символов |
| is_hidden | boolean Default: false Флаг для скрытия видео. По умолчанию false |
| category | integer Идентификатор категории. Получить список доступных категорий: https://rutube.ru/api/video/category/ |
| protected | boolean Default: false Флаг защиты видео. По умолчанию false |
object Дополнительные параметры для конвертера в формате JSON, например, xml-разметка: converter_params=%7B%22editor_xml%22%3A%22ftp%3A%5C%2F%5C%2Frutube%3pass%4010.122.50.222%5C%2FPR291117-A.xml%22%7D | |
| category_id | integer Идентификатор категории для совместимости. Получить список доступных категорий: https://rutube.ru/api/video/category/ |
{- "author": 0,
- "url": "string",
- "callback_url": "string",
- "errback_url": "string",
- "moder_callback_url": "string",
- "query_fields": [
- "string"
], - "extra": "string",
- "quality_report": true,
- "title": "Без названия",
- "description": "string",
- "is_hidden": false,
- "category": 0,
- "protected": false,
- "converter_params": {
- "additionalProp1": "string",
- "additionalProp2": "string"
}, - "category_id": 0
}{- "video_id": "95ef778b7813674fab9f6dc9e43cc1fb",
- "track_id": "19813210"
}| video_id required | string Идентификатор видео |
| fields | string Дополнительные поля для включения в ответ |
{- "id": "95ef778b7813674fab9f6dc9e43cc1fb",
- "title": "Видео-блог. Выпуск из Китая",
- "description": "Влог путешествия по Китаю. Пекин, Шанхай и милые деревушки",
- "is_audio": "false",
- "created_ts": "2024-11-20T10:28:42",
- "track_id": "19813210",
- "hits": "5",
- "duration": "2313123",
- "is_livestream": "false",
- "last_update_ts": "2024-11-20T10:28:42",
- "stream_type": null,
- "origin_type": "rtb",
- "author": {
- "id": "2312312",
- "name": "Суперавтор",
- "is_allowed_offline": "false"
}, - "is_adult": "false",
- "pg_rating": {
- "age": "12",
}, - "publication_ts": "2024-11-20T10:28:42",
- "extra_params": { },
- "future_publication": "2024-11-20T10:28:42",
- "is_club": "false",
- "is_classic": "false",
- "is_paid": "false",
- "product_id": null,
- "category": {
- "id": "2",
- "name": "Авто-мото",
- "short_name": "auto"
}, - "is_official": "false",
- "is_licensed": "false",
- "action_reason": {
- "id": "0",
- "name": ""
}, - "html": "<iframe width=\\\"720\\\" height=\\\"405\\\" src=\\\"https://rutube.ru/play/embed/95ef778b7813674fab9f6dc9e43cc1fb\\\" frameborder=\\\"0\\\" webkitAllowFullScreen mozallowfullscreen allowfullscreen allow=\\\"encrypted-media\\\"></iframe>",
- "is_hidden": "false",
- "has_high_quality": "false",
- "is_deleted": "false",
- "rutube_poster": null,
- "pepper": null,
- "show": null,
- "music": null,
- "hashtags": [ ],
- "all_tags": [ ],
- "restrictions": {
- "country": {
- "allowed": [
- "RU, WF"
], - "restricted": [
- "VA, VC"
]
}
}, - "feed_name": "Суперавтор",
- "feed_subscribers_count": "2312",
- "episode": "2",
- "season": "12",
- "is_serial": "false",
- "ext_id": null,
- "tv_show_id": "231",
- "club_params": "",
- "premier_url": null,
- "hide_comments": "false",
- "hide_chat": "false",
- "hide_likes": "false",
- "hide_dislikes": "false",
- "stream_end_ts": "2024-11-20T10:28:42",
- "is_original_content": "false",
- "kind_sign_for_user": "false",
- "topics": [ ],
- "properties": { },
- "is_on_air": "false",
- "is_reborn_channel": "false",
- "common_subscription_product_codes": [ ],
- "age_range": {
- "min": 0,
- "max": 0
}
}| video_id required | string Идентификатор видео |
Тело запроса
| title required | string Ваше название видео до 100 символов |
| description | string Ваше описание видео до 5000 символов |
| author | integer id канала в rutube, на котором опубликовано видео |
| is_adult | boolean Взрослый контент |
| category required | integer Идентификатор категории. Получить список доступных категорий: https://rutube.ru/api/video/category/ |
| is_hidden | boolean Скрытие ролика из публичного доступа |
{- "title": "string",
- "description": "string",
- "author": 0,
- "is_adult": true,
- "category": 0,
- "is_hidden": true
}{- "id": "95ef778b7813674fab9f6dc9e43cc1fb",
- "title": "Видео-блог. Выпуск из Китая",
- "description": "Влог путешествия по Китаю. Пекин, Шанхай и милые деревушки",
- "is_audio": "false",
- "created_ts": "2024-11-20T10:28:42",
- "track_id": "19813210",
- "hits": "5",
- "duration": "2313123",
- "is_livestream": "false",
- "last_update_ts": "2024-11-20T10:28:42",
- "stream_type": null,
- "origin_type": "rtb",
- "author": {
- "id": "2312312",
- "name": "Суперавтор",
- "is_allowed_offline": "false"
}, - "is_adult": "false",
- "pg_rating": {
- "age": "12",
}, - "publication_ts": "2024-11-20T10:28:42",
- "extra_params": { },
- "future_publication": "2024-11-20T10:28:42",
- "is_club": "false",
- "is_classic": "false",
- "is_paid": "false",
- "product_id": null,
- "is_official": "false",
- "is_licensed": "false",
- "action_reason": {
- "id": "0",
- "name": ""
}, - "html": "<iframe width=\\\"720\\\" height=\\\"405\\\" src=\\\"https://rutube.ru/play/embed/95ef778b7813674fab9f6dc9e43cc1fb\\\" frameborder=\\\"0\\\" webkitAllowFullScreen mozallowfullscreen allowfullscreen allow=\\\"encrypted-media\\\"></iframe>",
- "is_hidden": "false",
- "has_high_quality": "false",
- "is_deleted": "false",
- "rutube_poster": null,
- "pepper": null,
- "show": null,
- "music": null,
- "hashtags": [ ],
- "all_tags": [ ],
- "restrictions": {
- "country": {
- "allowed": [
- "RU, WF"
], - "restricted": [
- "VA, VC"
]
}
}, - "feed_name": "Суперавтор",
- "feed_subscribers_count": "2312",
- "episode": "2",
- "season": "12",
- "is_serial": "false",
- "ext_id": null,
- "tv_show_id": "231",
- "club_params": "",
- "premier_url": null,
- "hide_comments": "false",
- "hide_chat": "false",
- "hide_likes": "false",
- "hide_dislikes": "false",
- "stream_end_ts": "2024-11-20T10:28:42",
- "is_original_content": "false",
- "kind_sign_for_user": "false",
- "topics": [ ],
- "properties": { },
- "is_on_air": "false",
- "is_reborn_channel": "false",
- "common_subscription_product_codes": [ ]
}| video_id required | string Идентификатор видео |
Тело запроса
| file | string <binary> non-empty Файл изображения для обложки. |
{
}