{
"openapi": "3.0.0",
"info": {
"title": "Muz-tv.ru API",
"description": "\n Запросы производятся методами GET или POST.\n В случае POST-запроса, если явно не указано иное, заголовок Content-Type должен быть равен application/json, содержимое тела запроса должно быть в JSON-формате.\n\n# Общие аргументы запросов\n\n* Все методы принимают обязательный параметр **v**, который указывает версию метода. \n Таким образом смогут работать и обновленные, и предыдущие версии клиентов. \n Изменение второй цифры версии означает неломающие изменения, например добавление новых полей. \n Изменение первой цифры версии означает ломающие изменения, например удаление или переименование полей, или изменение всего формата ответа метода.\n\n* При вызове всех методов в заголовке Cookie должна отправляться кука с названием **session**, содержащая идентификатор сессии пользователя.\n\n* Часть методов (например, выставление лайков, голосование в чартах) доступна без авторизации, но для их работы требуется в заголовке Cookie отправлять куку с названием **vid**. \n Значением vid должен быть неизменяемый идентификатор пользователя длиной не более 32 символов, в простейшем случае это может быть единожды сгенерированный клиентом uuid-v4.\n\n* Все методы принимают обязательный параметр **client_id**, который клиент получает вместе с секретным ключом **client_secret** для доступа к API.\n\n* Все методы принимают обязательный параметр sig, который является подписью запроса. \n Значение sig вычисляется по следующему алгоритму: \n\n `sig = md5_hex(vid + params + client_secret)`\n\n Значение params — это конкатенация пар «имя=значение» отсортированных в алфавитном порядке по «имя» \n где «имя» — это название GET-параметра, передаваемого в функцию API, «значение» — значение GET-параметра. \n Если «значение» — массив, тогда его элементы склеиваются через запятую без пробела (например, `a[]=1&a[]=2&a[]=3` превращается в `a=1,2,3`).\n Разделитель в конкатенации не используется.\n Параметр sig при расчете подписи не учитывается, все остальные параметры запроса (при POST-запросе и в теле запроса и в queryString) должны учитываться при расчете. \n\n Пример - получение списка треков хит-онлайн на второй странице с обратной сортировкой по количеству комментариев. \n `GET http://muz-tv.ru/api/hit-online/?page=2&perpage=70&s=comments_count&o=desc&client_id=12345&v=1.1`\n\n Допустим, значение куки `vid` равно `5c29a3ee09eb4acd910ce6cca440e65c`, а `client_secret` равно `b5c5e8b8-3f96-493d-9ac4-6ae60a829a93`. \n Тогда подпись вычисляется как:\n `md5_hex(\"5c29a3ee09eb4acd910ce6cca440e65c\" + \"client_id=12345o=descpage=2perpage=70s=comments_countv=1.1\" + \"b5c5e8b8-3f96-493d-9ac4-6ae60a829a93\") = 8d2807b2606f4a93ee532b90078622d6`\n\n Следовательно, итоговый запрос будет выглядеть так:\n `GET http://muz-tv.ru/api/hit-online/?page=2&perpage=70&s=comments_count&o=desc&client_id=12345&v=1.1&sig=8d2807b2606f4a93ee532b90078622d6`\n",
"version": "1.0.0"
},
"servers": [
{
"url": "muz-tv.ru",
"description": "Muz-tv.ru API"
}
],
"paths": {
"/chart/": {
"get": {
"tags": [
"Чарты"
],
"summary": "Получение списка активных чартов.",
"description": "В v1.2 добавилось поле chart_type — идентификатор типа чарта, а также сменилась сортировка: по идентификатору типа чарта от старых к новым.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"charts": {
"$ref": "#/components/schemas/charts"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/chart_vote/{id}/": {
"post": {
"tags": [
"Чарты"
],
"summary": "Голосование за активный чарт.",
"description": "v1.2\nПараметры:\ntrack_id — integer|array - идентификаторы треков чарта, не более 3 (для одного трека можно передавать как массив из одного элемента, так и целое — ID трека, например: track_id=[123] или track_id=123, а для нескольких треков: track_id=[123,456])",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id чарта",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "ChartVote",
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"track_id": {
"description": "Идентификаторы треков чарта",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/chart/lastweek/": {
"get": {
"tags": [
"Чарты"
],
"summary": "Выдаются лидеры прошлой недели из раздела Чарты",
"description": "В v1.2 добавилось поле chart_type — идентификатор типа чарта",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"charts": {
"$ref": "#/components/schemas/last_week_charts"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/comments/": {
"get": {
"tags": [
"Комментарии"
],
"summary": "Получение постраничного списка комментариев к сущности, сортировка по дате добавления от новых к старым.",
"parameters": [
{
"name": "topic_id",
"in": "query",
"description": "Идентификатор темы комментариев",
"schema": {
"type": "string"
}
},
{
"name": "thread",
"in": "query",
"description": "Идентификатор ветки комментариев (если нужно получить ветку в рамках темы)",
"schema": {
"type": "string"
}
},
{
"name": "page",
"in": "query",
"description": "Номер страницы, по умолчанию 1",
"schema": {
"type": "string",
"default": "1"
}
},
{
"name": "perpage",
"in": "query",
"description": "количество элементов на одной странице, по умолчанию 50, максимум 100",
"schema": {
"type": "string",
"default": 50
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Комментарии приходят плоским списком, в каждом комментарии есть поле level, который указывает на вложенность комментария.\n * Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"total": {
"description": "Количество комментариев",
"type": "string",
"example": "12"
},
"list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/comments_list"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/add_comment/": {
"post": {
"tags": [
"Комментарии"
],
"summary": "Добавление комментария к сущности.",
"description": "v1.2\nЗаголовок User-Authorization должен содержать key=(токен), в котором в (токен) указан действующий токен доступа - access_token.",
"parameters": [
{
"$ref": "#/components/parameters/User-Authorization"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "AddComment",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"entity_type": {
"description": "Идентификатор типа сущности",
"type": "string"
},
"entity_id": {
"description": "Идентификатор самой сущности, например идентификатор звезды",
"type": "string"
},
"content": {
"description": "Текст комментария, нужно отсылать в теле запроса",
"type": "string"
},
"comment_id": {
"description": "Идентификатор комментария, присылается в случае добавления ответа на существующий комментарий",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-2 - требуется авторизация\n-3 - не передан один из обязательных параметров entity_type, entity_id или content\n-4 - такой тип сущности не существует или сущность не найдена\n-5 - к этой сущности запрещено добавлять комментарии\n-6 - пользователь забанен и не может добавлять комментарии\n-7 - текст комментария содержит запрещенные слова\n-8 - пользователь должен быть зарегистрирован больше 3х дней\n-10 - непредвиденная ошибка (комментарий добавить не удалось)\n-11 - если комментарий для новости, то она должна быть опубликована и ей должно быть не более 2х недель\n-12 - комментарий, на который пишется ответ, не найден",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"topic_id": {
"description": "Идентификатор темы комментариев",
"type": "string",
"example": "23979"
},
"comment_id": {
"description": "Идентификатор комментария",
"type": "string",
"example": "870729"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/dacha-chart": {
"get": {
"tags": [
"Комментарии"
],
"summary": "Получить сообщение Dacha-чарта",
"description": "Получить сообщение Dacha-чарта",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможных ошибок нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"message": {
"type": "string"
}
},
"type": "object",
"maxItems": 12345,
"minItems": 1
}
}
}
}
}
}
}
},
"/hit-online/": {
"get": {
"tags": [
"Хит-онлайн"
],
"summary": "Получение постраничного списка треков",
"parameters": [
{
"name": "page",
"in": "query",
"description": "номер страницы, по умолчанию 1",
"schema": {
"type": "string",
"default": 1
}
},
{
"name": "perpage",
"in": "query",
"description": "количество элементов на одной странице, по умолчанию 50, максимум 100",
"schema": {
"type": "string",
"default": 50
}
},
{
"$ref": "#/components/parameters/sing_with_star"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"list": {
"$ref": "#/components/schemas/hit_list"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/hit-online/{id}/": {
"get": {
"tags": [
"Хит-онлайн"
],
"summary": "Получение информации о треке по идентификатору.",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id трека",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/hit"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/love-chat": {
"get": {
"tags": [
"Комментарии"
],
"summary": "Получить сообщение Love-чата",
"description": "Получить сообщение Love-чата",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможных ошибок нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"message": {
"type": "string"
}
},
"type": "object",
"maxItems": 12345,
"minItems": 1
}
}
}
}
}
}
}
},
"/mobile/likemeter/current_time/": {
"get": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Получение текущего времени, для определения из Москвы пользователь или нет.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"current_time": {
"$ref": "#/components/schemas/current_time"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/likemeter/current_clip_emojis/": {
"get": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Получение клипа с эмодзи, идущего онлайн.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -5 - сейчас клипа нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"clip_card": {
"$ref": "#/components/schemas/clip_card"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/likemeter/get_current_clip_emojis/": {
"get": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Получение клипа c эмодзи, идущего в онлайне для эфира. ",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -5 - сейчас клипа нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"clip_card": {
"$ref": "#/components/schemas/clip_card"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/likemeter/current_clip_emojis/vote/": {
"post": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Голосование за эмодзи клипа, идущего онлайн.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"requestBody": {
"request": "EmojiVote",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"clip_card_id": {
"description": "id клипа",
"type": "integer"
},
"emoji_id": {
"description": "id эмодзи",
"type": "integer"
},
"uuid": {
"description": "Уникальный идентификатор устройства",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - такой токен не существует,\n -3 - не передан обязательный параметр - uuid, clip_card_id или emoji_id,\n -4 - не найден пользователь по данному токену,\n -5 - пользователь должен быть зарегистрирован больше 3х дней,\n -6 - наступило время, после которого не принимаются голоса за клип(10 секунд),\n -7 - данный клип не идет онлайн в текущее время,\n -8 - пользователь проголосовал за клип больше 5 раз",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"left_count_user_votes": {
"$ref": "#/components/schemas/left_count_user_votes"
},
"clip_card_emoji": {
"$ref": "#/components/schemas/clip_card_emoji"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/likemeter/current_day_clips_emojis/": {
"get": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Получение клипов с эмодзи, идущих в течение дня в прямом эфире. Только для пользователей не из Москвы, определяется по локальному времени date.",
"parameters": [
{
"name": "date",
"in": "query",
"description": "локальная дата и время пользователя, например 2019-10-23 17:18:00",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -5 - не передан обязательный параметр - date,\n -6 - переданная дата не совпадает с текущей датой на сервере, отдать можем только на текущий день,\n -7 - время пользователя не отличается на +/- 1 час от МСК",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"clip_cards": {
"$ref": "#/components/schemas/clip_cards"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/likemeter/current_day_clips_emojis/vote/": {
"post": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Голосование за эмодзи клипа, находящегося в списке клипов дня. Только для пользователей не из Москвы, определяется по локальному времени date.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "CurentEmojiVote",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"clip_card_id": {
"description": "id клипа",
"type": "integer"
},
"emoji_id": {
"description": "id эмодзи",
"type": "integer"
},
"uuid": {
"description": "Уникальный идентификатор устройства",
"type": "string"
},
"date": {
"description": "локальная дата и время пользователя, например 2019-10-23 17:18:00",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - такой токен не существует,\n -3 - не передан обязательный параметр - uuid, clip_card_id или emoji_id,\n -4 - не найден пользователь по данному токену,\n -5 - пользователь должен быть зарегистрирован больше 3х дней,\n -6 - переданная дата не совпадает с текущей датой на сервере, отдать можем только на текущий день,\n -7 - время пользователя не отличается на +/- 1 час от МСК,\n -8 - отключена настройка 'Показывать лайкометр во фронтенде',\n -9 - в текущий день недели лайкометр не активен,\n -10 - клип не идёт сегодня в эфире,\n -11 - пользователь проголосовал за клип больше 5 раз",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"left_count_user_votes": {
"$ref": "#/components/schemas/left_count_user_votes"
},
"clip_card_emoji": {
"$ref": "#/components/schemas/clip_card_emoji"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/likemeter/today/": {
"get": {
"tags": [
"Методы для Лайкометра"
],
"summary": "Получение времени начала и конца лайкометра.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - сегодня лайкометра нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"begin": {
"description": "Время начала",
"type": "string",
"example": "2019-10-24 14:25:04"
},
"end": {
"description": "Время окончания",
"type": "string",
"example": "2019-10-24 14:25:04"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/login/": {
"post": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Получить новый токен для пользователя мобильного приложения",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "GetToken",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"device_id": {
"description": "идентификатор устройства",
"type": "string"
},
"device_type": {
"description": "тип устройства (1-ios, 2-android)",
"type": "integer"
},
"email": {
"description": "почтовый ящик",
"type": "string"
},
"password": {
"description": "пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан один из обязательных параметров email или password\n -4 - такой пользователь не существует\n -5 - некорректный пароль\n -6 - пользователь заблокирован\n -9 - ошибка валидации типа устройства",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"mobile_api_user": {
"$ref": "#/components/schemas/mobile_api_user"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/recover_password/": {
"get": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Восстановить пароль для пользователя мобильного приложения",
"parameters": [
{
"name": "email",
"in": "path",
"description": "почтовый ящик",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан обязательный параметр - email\n -4 - такой пользователь не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/register/": {
"post": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Добавить нового пользователя через мобильное приложение",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "Register",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"device_id": {
"description": "идентификатор устройства",
"type": "string"
},
"device_type": {
"description": "тип устройства (1-ios, 2-android)",
"type": "integer"
},
"email": {
"description": "почтовый ящик",
"type": "string"
},
"name": {
"description": "никнейм (поле Ваше имя)",
"type": "string"
},
"password": {
"description": "пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан один из обязательных параметров name, email или password\n -6 - ошибка валидации никнейма\n -7 - ошибка валидации почтового ящика\n -8 - ошибка валидации пароля\n -9 - ошибка валидации типа устройства",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"mobile_api_user": {
"$ref": "#/components/schemas/mobile_api_user"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/get_user_vkontakte/": {
"get": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Получить пользователя мобильного приложения по данным из Вконтакте",
"parameters": [
{
"name": "code",
"in": "query",
"description": "токен доступа пользователя Вконтакте",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "device_id",
"in": "query",
"description": "идентификатор устройства",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "device_type",
"in": "query",
"description": "тип устройства (1-ios, 2-android)",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "state",
"in": "query",
"description": "токен состояния пользователя Вконтакте",
"required": false,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан обязательный параметр - code\n -5 - ошибка из api Вконтакте",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"mobile_api_user": {
"$ref": "#/components/schemas/mobile_api_user"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
},
"201": {
"description": "Если почтовый ящик пользователя не найден, то создается временный профиль для регистрации из социальных сетей. Время хранения профиля - неделя:\n -4 - почтовый ящик пользователя не найден"
}
}
}
},
"/mobile/get_user_facebook/": {
"get": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Получить пользователя мобильного приложения по данным из Facebook",
"parameters": [
{
"name": "code",
"in": "query",
"description": "токен доступа пользователя Facebook",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "device_id",
"in": "query",
"description": "идентификатор устройства",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "device_type",
"in": "query",
"description": "тип устройства (1-ios, 2-android)",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "state",
"in": "query",
"description": "токен состояния пользователя Facebook",
"required": false,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан обязательный параметр - code\n -5 - ошибка из api Facebook",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"mobile_api_user": {
"$ref": "#/components/schemas/mobile_api_user"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
},
"201": {
"description": "Если почтовый ящик пользователя не найден, то создается временный профиль для регистрации из социальных сетей. Время хранения профиля - неделя:\n -4 - почтовый ящик пользователя не найден"
}
}
}
},
"/mobile/register_social_user/": {
"post": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Регистрация пользователя по e-mail и временному профилю из социальной сети",
"parameters": [
{
"name": "register_token",
"in": "query",
"description": "токен регистрации по e-mail",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "RegisterSocial",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"email": {
"description": "почтовый ящик",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан один из обязательных параметров email или register_token\n -4 - не найден временный профиль по указанному токену register_token\n -5 - такой почтовый ящик уже существует у другого пользователя\n -6 - невалидный email",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"mobile_api_user": {
"$ref": "#/components/schemas/mobile_api_user"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/user/": {
"get": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Отобразить данные о пользователе из мобильного приложения",
"parameters": [
{
"$ref": "#/components/parameters/User-Authorization"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан обязательный параметр - токен доступа\n -4 - такой пользователь не существует\n -6 - пользователь заблокирован",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
}
}
},
"post": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Обновить данные о пользователе из мобильного приложения",
"parameters": [
{
"$ref": "#/components/parameters/User-Authorization"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "UpdateUser",
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"email": {
"description": "почтовый ящик",
"type": "string"
},
"name": {
"description": "никнейм (поле Ваше имя)",
"type": "string"
},
"first_name": {
"description": "Имя",
"type": "string"
},
"last_name": {
"description": "Фамилия",
"type": "string"
},
"phone": {
"description": "телефон",
"type": "string"
},
"city": {
"description": "город",
"type": "string"
},
"gender": {
"description": "пол (м - 1, ж - 2)",
"type": "integer"
},
"birthday": {
"description": "день рождения (YYYY-MM-DD)",
"type": "string"
},
"password": {
"description": "новый пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -3 - не передан обязательный параметр - токен доступа\n -4 - такой пользователь не существует\n -5 - ошибка валидации данных",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"profile": {
"$ref": "#/components/schemas/profile"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/mobile/user/logout/": {
"post": {
"tags": [
"Авторизация и регистрация пользователя"
],
"summary": "Удалить токен доступа текущего пользователя мобильного приложения",
"parameters": [
{
"$ref": "#/components/parameters/User-Authorization"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/newslist/": {
"get": {
"tags": [
"Новости"
],
"summary": "Получение постраничного списка новостей.",
"parameters": [
{
"name": "page",
"in": "query",
"description": "номер страницы, по умолчанию 1",
"schema": {
"type": "string",
"default": "1"
}
},
{
"name": "perpage",
"in": "query",
"description": "количество элементов на одной странице, по умолчанию 50, максимум 100",
"schema": {
"type": "string",
"default": 50
}
},
{
"name": "tag",
"in": "query",
"description": "Только новости с тэгом",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "short",
"in": "query",
"description": "Только короткие новости",
"schema": {
"type": "boolean",
"default": "false"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"total": {
"description": "Количество новостей",
"type": "string",
"example": "12"
},
"item": {
"$ref": "#/components/schemas/news_list"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/newsitem/{id}/": {
"get": {
"tags": [
"Новости"
],
"summary": "Получение новости по идентификатору.",
"description": "Если в тексте новости встречаются вставки фото или роликов Youtube, то соответствующее места вставки помечается как {image_N} или {video_M}, где N и M - порядковые номера соответственно в массивах images и video\nВ v1.2 остальные виджеты заменяются на хтмл автоматически",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id новости",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-13 - Новость с данным идентификатором не найдена\n-14 - Новость с данным идентификатором исключена из выдачи по API",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/news_full"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/newsitembyalias/{alias}/": {
"get": {
"tags": [
"Новости"
],
"summary": "Получение новости по алиасу.",
"description": "Если в тексте новости встречаются вставки фото или роликов Youtube, то соответствующее места вставки помечается как {image_N} или {video_M}, где N и M - порядковые номера соответственно в массивах images и video\nВ v1.2 остальные виджеты заменяются на хтмл автоматически",
"parameters": [
{
"name": "alias",
"in": "path",
"description": "alias новости",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-13 - Новость с данным алиасом не найдена\n-14 - Новость с данным алиасом исключена из выдачи по API",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/news_full"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/newsitem/create": {
"post": {
"tags": [
"Новости"
],
"summary": "Создать новость",
"description": "",
"operationId": "6f1df93b481443226111b8242598063a",
"parameters": [
{
"name": "title",
"in": "query",
"description": "Заголовок (до 150 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "anons",
"in": "query",
"description": "Анонс (до 350 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "social[general_title]",
"in": "query",
"description": "Заголовок для соц. сетей (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "social[general_description]",
"in": "query",
"description": "Анонс для соц. сетей (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "author_name",
"in": "query",
"description": "Имя автора (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "text",
"in": "query",
"description": "Текст новости (до 30 000 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "ImageStore",
"required": false,
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"preview": {
"description": "Картинка-исходник (форматы: png,jpeg,gif, минимальные размеры: 1200x628)",
"type": "file"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/news_full"
}
},
"type": "object"
}
}
}
}
},
"422": {
"description": "Validation exception"
}
}
}
},
"/newsitem/{id}": {
"post": {
"tags": [
"Новости"
],
"summary": "Обновить новость",
"description": "",
"operationId": "12466358670eae448f4382f45fe47253",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id новости",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "title",
"in": "query",
"description": "Заголовок (до 150 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "anons",
"in": "query",
"description": "Анонс (до 350 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "social[general_title]",
"in": "query",
"description": "Заголовок для соц. сетей (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "social[general_description]",
"in": "query",
"description": "Анонс для соц. сетей (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "author_name",
"in": "query",
"description": "Имя автора (до 100 символов)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "text",
"in": "query",
"description": "Текст новости (до 30 000 символов)",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"requestBody": {
"request": "ImageUpdate"
},
"responses": {
"200": {
"description": "Возможные ошибки(status):\n * -13 - Новость с данным идентификатором не найдена (или soft deleted)\n * -14 - Новость с данным идентификатором исключена из выдачи по API",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/news_full"
}
},
"type": "object"
}
}
}
}
},
"422": {
"description": "Validation exception"
}
}
},
"delete": {
"tags": [
"Новости"
],
"summary": "Удалить новость (soft delete)",
"description": "",
"operationId": "744108dcea3d8779fbe38380056708e9",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id новости",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n * -13 - Новость с данным идентификатором не найдена (или soft deleted)\n * -14 - Новость с данным идентификатором исключена из выдачи по API"
},
"422": {
"description": "Validation exception"
}
}
}
},
"/random-share-qr-text/": {
"get": {
"tags": [
"Новости"
],
"summary": "Получение рандомной новости за сегодня из 'Промо QR'",
"operationId": "acc3c866d7df8530d6b4c132f5714134",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - не нашлось ни одной новости на сегодня",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"text": {
"description": "Заголовок новости",
"type": "string",
"example": "Sample text"
},
"link": {
"description": "Ссыллка в QR",
"type": "string",
"example": "https://google.com/"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/online/": {
"get": {
"tags": [
"Эфир"
],
"summary": "Получение информации об онлайн-трансляции.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n -1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/item_online"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/projects/": {
"get": {
"tags": [
"Проекты"
],
"summary": "Получение списка проектов.",
"description": "В версии 1.1 ответ идентичен /api/video_folder/{folder_id}/.\n В версии 1.2 отдаются все проекты, даже если видео нет (для релевантных полей будет null)\n Поле anons переименовано в description, поле image_big в preview_mobile\n сам массив folders переименован в projects",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"201": {
"description": "V 1.1\n \n Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"folders": {
"type": "array",
"items": {
"$ref": "#/components/schemas/video_folders"
}
}
},
"type": "object"
}
}
}
}
},
"200": {
"description": "V 1.2\n \n Возможные ошибки(status):\n-1 - такой токен не существует"
}
}
}
},
"/projects/get_nearest_show_time/{alias}": {
"get": {
"tags": [
"Проекты"
],
"summary": "Получение ближайшего времени эфира.",
"parameters": [
{
"name": "alias",
"in": "path",
"description": "Алиас проекта",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "V 1.2
Возможные ошибки(status):
-1 - такой токен не существует
-2 - проект с таким alias не найден",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"times": {
"type": "string",
"example": "2025-10-06T16:00:00.000000Z"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/qrutaya_ohota": {
"get": {
"tags": [
"Эфир"
],
"summary": "Получить ссылку для QRутой Охоты",
"description": "Получить ссылку для текущей передачи",
"operationId": "185639563267cc0eea740ff643147bcd",
"parameters": [
{
"name": "format",
"in": "query",
"description": "Формат выходной ссылки",
"required": true,
"schema": {
"type": "string",
"enum": [
"json",
"qr"
]
}
},
{
"name": "offset",
"in": "query",
"description": "Смещенеие по часовым поясам (в часах, относительно Москвы. По умолч. = 0)",
"required": false,
"schema": {
"type": "number"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки (status -1):\n Current program is not a clip,\n Current clip has no related track,\n Incorrect value for format",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"url": {
"type": "string"
}
},
"type": "object",
"maxItems": 1,
"minItems": 1
}
}
}
}
}
}
}
},
"/qrutaya_ohota/add/": {
"post": {
"tags": [
"Эфир"
],
"summary": "Засчитать скан QR кода",
"description": "v1.2 Попытка засчитать сканирование для QRутой охоты",
"operationId": "fcb2b7143ad907b57e188b54c753093e",
"parameters": [
{
"name": "qr",
"in": "query",
"description": "Alias QR кода",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "user_ip",
"in": "query",
"description": "IP пользователя",
"required": false,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/User-Authorization"
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки (status -1):\n You must be logged in,\n Время действия этого QR кода истекло. Ищите новые!\n Вы уже активировали этот QR. Ищите новые!",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/shopqr": {
"get": {
"tags": [
"Эфир"
],
"summary": "Получить информацию о ближайшем QR в эфире",
"description": "Получить информацию о ближайшем QR в эфире",
"operationId": "f4ab26648de1c113d74a975a243a7e0d",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"0",
"7"
]
}
},
{
"name": "pl",
"in": "query",
"description": "плейлист",
"required": false,
"schema": {
"type": "string",
"enum": [
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки (status -1):\n Ближайших куаров нет",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"url": {
"type": "string"
}
},
"type": "object",
"maxItems": 1,
"minItems": 1
}
}
}
}
}
}
}
},
"/stars/": {
"get": {
"tags": [
"Звезды"
],
"summary": "Получение постраничного списка звезд.",
"parameters": [
{
"name": "page",
"in": "query",
"description": "номер страницы, по умолчанию 1",
"schema": {
"type": "string",
"default": "1"
}
},
{
"name": "perpage",
"in": "query",
"description": "количество элементов на одной странице, по умолчанию 50, максимум 100",
"schema": {
"type": "string",
"default": 50
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"total": {
"description": "Количество звезд",
"type": "string",
"example": "12"
},
"list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/star_list_item"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/stars/{id}/": {
"get": {
"tags": [
"Звезды"
],
"summary": "Получение информации о звезде по идентификатору.",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id звезды",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"item": {
"$ref": "#/components/schemas/star"
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/stars/discussed/": {
"get": {
"tags": [
"Звезды"
],
"summary": "Выдаются три записи о звездах с максимальным количеством новостей о них за неделю",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"count": {
"description": "Количество звезд",
"type": "string",
"example": "3"
},
"list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/star_list_item"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/stars/recommended/": {
"get": {
"tags": [
"Звезды"
],
"summary": "Выдаются три записи с максимальным рейтингом от редакции",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"count": {
"description": "Количество звезд",
"type": "string",
"example": "3"
},
"list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/star_list_item"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/superannounces/": {
"get": {
"tags": [
"Суперанонсы"
],
"summary": "Получение списка Суперанонсов.",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"announces": {
"type": "array",
"items": {
"$ref": "#/components/schemas/announce"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/tvguide/": {
"get": {
"tags": [
"ТВ программа"
],
"summary": "Получение программы передач.",
"description": "В v1.2 добавилось поле premiere — премьера, а также сменился тип поля onair - теперь это boolean",
"parameters": [
{
"name": "date",
"in": "query",
"description": "дата в формате гггг-мм-дд, по умолчанию текущий день",
"schema": {
"type": "string",
"default": "2019-10-11"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1",
"1.2"
]
}
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"nextDate": {
"description": "Следующая дата",
"type": "string",
"example": "2018-03-12"
},
"prevDate": {
"description": "Предыдущая дата",
"type": "string",
"example": "2018-03-10"
},
"schedule": {
"type": "array",
"items": {
"$ref": "#/components/schemas/schedule"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/video_folder/": {
"get": {
"tags": [
"Видео архив"
],
"summary": "Получение списка категорий видео (папки 1-ого уровня).",
"parameters": [
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "Возможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"folders": {
"type": "array",
"items": {
"$ref": "#/components/schemas/folders"
}
}
},
"type": "object"
}
}
}
}
}
}
}
},
"/video_folder/{folder_id}/": {
"get": {
"tags": [
"Видео архив"
],
"summary": "Получение списка категорий видео (папки 2-ого уровня).",
"parameters": [
{
"name": "folder_id",
"in": "path",
"description": "Идентификатор папки",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/client_id"
},
{
"$ref": "#/components/parameters/client_secret"
},
{
"$ref": "#/components/parameters/v"
},
{
"$ref": "#/components/parameters/sig"
},
{
"$ref": "#/components/parameters/Cookie"
},
{
"$ref": "#/components/parameters/host"
}
],
"responses": {
"200": {
"description": "По умолчанию применяется сортировка по параметру last_video_pubdate\nВозможные ошибки(status):\n-1 - такой токен не существует",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"properties": {
"status": {
"$ref": "#/components/schemas/status"
},
"folders": {
"type": "array",
"items": {
"$ref": "#/components/schemas/video_folders"
}
}
},
"type": "object"
}
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"status": {
"title": "Код ответа",
"description": "Код ответа",
"type": "string",
"xml": {
"name": "status"
},
"example": "0"
},
"status_not_found_email": {
"description": "Код ответа",
"type": "string",
"xml": {
"name": "status_not_found_email"
},
"example": "-4"
},
"left_count_user_votes": {
"description": "Количество оставшихся голосов у пользователя",
"type": "integer",
"xml": {
"name": "left_count_user_votes"
},
"example": 2
},
"announce": {
"properties": {
"id": {
"description": "Идентификатор анонса",
"type": "string",
"example": "843"
},
"image": {
"description": "Изображение",
"type": "string",
"example": "http://muz-tv.ru/pic/video/4/b/4bd39daee6e7f413bedb102601b93678.jpg"
},
"link": {
"description": "Ссылка",
"type": "string",
"example": "http://muz-tv.ru/news/ololo/"
}
},
"type": "object",
"xml": {
"name": "announce"
}
},
"clip_card": {
"description": "Карточка клипа",
"properties": {
"id": {
"type": "string",
"example": "1"
},
"title": {
"description": "исполнитель - название клипа",
"type": "string",
"example": "LUIS FONSI FEAT. DADDY YANKEE - Despacito"
},
"date": {
"description": "время начала показа",
"type": "string",
"example": "2019-10-24 14:25:04"
},
"duration": {
"description": "продолжительность клипа в секундах",
"type": "string",
"example": 260
},
"clip_card_emojis": {
"$ref": "#/components/schemas/clip_card_emojis"
}
},
"type": "object",
"xml": {
"name": "clip_card"
}
},
"clip_cards": {
"description": "Карточки клипов",
"type": "array",
"items": {
"properties": {
"id": {
"type": "string",
"example": "1"
},
"title": {
"description": "исполнитель - название клипа",
"type": "string",
"example": "LUIS FONSI FEAT. DADDY YANKEE - Despacito"
},
"date": {
"description": "время начала показа",
"type": "string",
"example": "2019-10-24 14:25:04"
},
"duration": {
"description": "продолжительность клипа в секундах",
"type": "string",
"example": 260
},
"clip_card_emojis": {
"$ref": "#/components/schemas/clip_card_emojis"
}
},
"type": "object"
},
"xml": {
"name": "clip_cards"
}
},
"clip_card_emoji": {
"description": "Одна эмодзи карточки клипа",
"properties": {
"id": {
"type": "string",
"example": "1"
},
"title": {
"description": "название эмодзи",
"type": "string",
"example": "Лайк"
},
"image": {
"description": "url изображения",
"type": "string",
"example": "http:\\/\\/muz-tv.ru\\/storage\\/images\\/emoji\\/thumb\\/BRSRTEHwcb9AiwxobGWtOgZog7LGa140Zx1nDHHj.jpe"
},
"percents": {
"description": "количество процентов людей, проголосовавших за данную эмодзи",
"type": "string",
"example": 25
}
},
"type": "object",
"xml": {
"name": "clip_card_emoji"
}
},
"clip_card_emojis": {
"description": "Все эмодзи карточки клипа",
"type": "array",
"items": {
"properties": {
"id": {
"type": "string",
"example": "1"
},
"title": {
"description": "название эмодзи",
"type": "string",
"example": "Лайк"
},
"image": {
"description": "url изображения",
"type": "string",
"example": "http:\\/\\/muz-tv.ru\\/storage\\/images\\/emoji\\/thumb\\/BRSRTEHwcb9AiwxobGWtOgZog7LGa140Zx1nDHHj.jpe"
},
"percents": {
"description": "количество процентов людей, проголосовавших за данную эмодзи",
"type": "string",
"example": 25
}
},
"type": "object"
},
"xml": {
"name": "clip_card_emojis"
}
},
"comments_list": {
"properties": {
"id": {
"description": "Идентификатор комментария",
"type": "string",
"example": "190703"
},
"content": {
"description": "Текст комментария",
"type": "string",
"example": "классная песня=) Домик ваще классно поёт"
},
"admin_content": {
"description": "Ответ администратора на данный комментарий",
"type": "string",
"example": ""
},
"created": {
"description": "Дата создания",
"type": "string",
"example": "2011-11-18 19:51:24"
},
"author_id": {
"description": "Идентификатор пользователя",
"type": "string",
"example": "380472"
},
"author_name": {
"description": "Имя пользователя",
"type": "string",
"example": "some_nick"
},
"avatar": {
"$ref": "#/components/schemas/avatar"
},
"level": {
"description": "Уровень вложенности комментария",
"type": "string",
"example": "0"
},
"hidden": {
"description": "Если 1, то комментарий скрыт и не должен отображаться",
"type": "string",
"example": "0"
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "3"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "2"
}
},
"type": "object",
"xml": {
"name": "comments_list"
}
},
"avatar": {
"description": "Аватар пользователя",
"properties": {
"small": {
"description": "Маленькая картинка",
"type": "string",
"example": "/pic/a/b/_avatarsmall.jpg"
},
"normal": {
"description": "Картинка",
"type": "string",
"example": "/pic/c/d/_avatar.jpg"
}
},
"type": "object",
"xml": {
"name": "avatar"
}
},
"current_time": {
"description": "Текущее время на сервере",
"type": "array",
"items": {
"properties": {
"date": {
"description": "текущее время",
"type": "string",
"example": "2019-10-24 14:25:04"
}
},
"type": "object"
},
"xml": {
"name": "current_time"
}
},
"hit_list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/hit"
},
"xml": {
"name": "hit_list"
}
},
"hit": {
"properties": {
"id": {
"description": "id трека",
"type": "string",
"example": "12"
},
"track_title": {
"description": "Название трека",
"type": "string",
"example": "Реальные люди"
},
"star_title": {
"description": "Имя исполнителя",
"type": "string",
"example": "ДОМИНИК ДЖОКЕР"
},
"preview": {
"description": "Картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/a/da4562171b61e69a4ac1eefb55fcd8a3.jpg"
},
"preview_big": {
"description": "Большая картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/b/da456dsadasdsfdgfrehcs454543232.jpg"
},
"pubdate": {
"description": "Дата публикации",
"type": "string",
"example": "2016-07-03 11:32:02"
},
"file": {
"description": "Ссылка на файл",
"type": "string",
"example": "http://muz-tv.ru/audio/a/4/a4ddf458075ab23a71eeb16d16e09f09.mp3"
},
"duration": {
"description": "Длительность",
"type": "string",
"example": "222"
},
"topic_id": {
"description": "Идентификатор темы комментариев, если тема не существует, то перед добавлением первого комментария её надо создать",
"type": "string",
"example": "13483"
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": "7"
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "694"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "2"
},
"sing_with_star": {
"description": "Трек со звездой",
"type": "string",
"example": "0"
},
"star_ids": {
"description": "id звезд",
"type": "array",
"items": {
"example": "25287, 21421"
}
},
"lyrics_file": {
"description": "Файл с текстом песни",
"type": "string",
"example": "http://muz-tv.ru/pic/d/a/da4562171b61e69a4ac1eefb55fcd8a3.lrc"
}
},
"type": "object",
"xml": {
"name": "hit"
}
},
"mobile_api_user": {
"description": "Пользователь мобильного приложения",
"type": "array",
"items": {
"properties": {
"id": {
"type": "string",
"example": "5"
},
"user_id": {
"description": "id пользователя",
"type": "string",
"example": "1"
},
"access_token": {
"description": "токен доступа",
"type": "string",
"example": "RA4g6a4tqKo0uPjtEU6tTKXLSXqUOKk8"
},
"created": {
"description": "дата создания",
"type": "string",
"example": "2019-10-18 13:20:10"
},
"device_id": {
"description": "идентификатор устройства",
"type": "string",
"example": "dwew221Ko0uPjtEU32fXqUOKk8"
},
"device_type": {
"description": "тип устройства (1-ios, 2-android)",
"type": "string",
"example": "1"
}
},
"type": "object"
},
"xml": {
"name": "mobile_api_user"
}
},
"news_list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/news"
},
"xml": {
"name": "news_list"
}
},
"news": {
"properties": {
"id": {
"description": "id новости",
"type": "string",
"example": "12"
},
"title": {
"description": "Название новости",
"type": "string",
"example": "15 лучших песен Jah Khalib’а"
},
"anons": {
"description": "Анонс новости",
"type": "string",
"example": "Плейлист ко дню рождения артиста"
},
"preview": {
"description": "Картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/a/da4562171b61e69a4ac1eefb55fcd8a3.jpg"
},
"preview_big": {
"description": "Большая картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/b/da456dsadasdsfdgfrehcs454543232.jpg"
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": "7"
},
"pubdate": {
"description": "Дата публикации",
"type": "string",
"example": "2016-07-03 11:32:02"
},
"star_ids": {
"description": "id звезд",
"type": "array",
"items": {
"example": "25287, 21421"
}
},
"topic_id": {
"description": "Идентификатор темы комментариев, если тема не существует, то перед добавлением первого комментария её надо создать",
"type": "string",
"example": "13483"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "2"
},
"visits": {
"description": "Количество просмотров",
"type": "string",
"example": "89"
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "694"
}
},
"type": "object",
"xml": {
"name": "news"
}
},
"item_online": {
"properties": {
"id": {
"type": "string",
"example": "1"
},
"topic_id": {
"description": "идентификатор темы комментариев, если тема не существует, то перед добавлением первого комментария её надо создать",
"type": "string",
"example": "16869"
},
"rutube_id": {
"description": "id трансляции",
"type": "string",
"example": "10711575"
},
"comments_count": {
"description": "количество комментариев",
"type": "string",
"example": "6038"
},
"entity_type_id": {
"description": "идентификатор типа сущности",
"type": "string",
"example": "16"
}
},
"type": "object",
"xml": {
"name": "item_online"
}
},
"star_list_item": {
"properties": {
"id": {
"description": "id звезды",
"type": "string",
"example": "1280"
},
"pseudonym": {
"description": "Псевдоним",
"type": "string",
"example": "МОТ"
},
"real_name": {
"description": "Настоящее имя",
"type": "string",
"example": "Матвей Мельников"
},
"biography_anons": {
"description": "Краткая биография",
"type": "string",
"example": "краткая биография"
},
"preview": {
"description": "Картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/0/7/0708d3f8a22cbc788602ce5f67ab6841.jpg"
},
"birthday": {
"description": "Дата рождения",
"type": "string",
"example": "02-03-1990"
},
"alias": {
"description": "Транслит",
"type": "string",
"example": "mot"
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": "15"
},
"fans_count": {
"description": "Количество фанатов",
"type": "string",
"example": "123"
},
"creation_year": {
"description": "Год создания группы",
"type": "string",
"example": "2006"
},
"rating": {
"description": "Рейтинг",
"type": "string",
"example": "9"
},
"topic_id": {
"description": "Идентификатор темы комментариев",
"type": "string",
"example": "23979"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "3"
}
},
"type": "object",
"xml": {
"name": "star_list_item"
}
},
"star": {
"properties": {
"id": {
"description": "id звезды",
"type": "string",
"example": "1280"
},
"pseudonym": {
"description": "Псевдоним",
"type": "string",
"example": "МОТ"
},
"real_name": {
"description": "Настоящее имя",
"type": "string",
"example": "Матвей Мельников"
},
"biography_anons": {
"description": "Краткая биография",
"type": "string",
"example": "краткая биография"
},
"biography_text": {
"description": "Полная биография",
"type": "string",
"example": "полная биография"
},
"country": {
"description": "Страна",
"type": "string",
"example": "Россия"
},
"preview": {
"description": "Картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/0/7/0708d3f8a22cbc788602ce5f67ab6841.jpg"
},
"preview_big": {
"description": "Картинка большая",
"type": "string",
"example": "http://muz-tv.ru/pic/e/3/e36c8b87d396ed5cff6862cd832f9d07.jpg"
},
"birthday": {
"description": "Дата рождения",
"type": "string",
"example": "02-03-1990"
},
"gender": {
"description": "Пол",
"type": "string",
"example": "1"
},
"creation_year": {
"description": "Год создания группы",
"type": "string",
"example": "2006"
},
"genres": {
"$ref": "#/components/schemas/genres"
},
"rating": {
"description": "Рейтинг",
"type": "string",
"example": "9"
},
"fans_count": {
"description": "Количество фанатов",
"type": "string",
"example": "123"
},
"letters": {
"type": "array",
"items": {
"example": "12, 42"
}
},
"alias": {
"description": "Транслит",
"type": "string",
"example": "mot"
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": "15"
},
"topic_id": {
"description": "Идентификатор темы комментариев",
"type": "string",
"example": "23979"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "3"
}
},
"type": "object",
"xml": {
"name": "star"
}
},
"genres": {
"type": "array",
"items": {
"$ref": "#/components/schemas/genre"
},
"xml": {
"name": "genres"
}
},
"genre": {
"properties": {
"id": {
"description": "id жанра",
"type": "string",
"example": "1"
},
"title": {
"description": "Название",
"type": "string",
"example": "Музыкант"
}
},
"type": "object",
"xml": {
"name": "genre"
}
},
"temporary_social_user": {
"description": "Временный профиль из социальной сети",
"type": "array",
"items": {
"properties": {
"register_token": {
"description": "токен для регистрации e-mail",
"type": "string",
"example": "RA4g6a4tqKo0uPjtEU6tTKXLSXqUOKk8"
},
"name": {
"description": "никнейм",
"type": "string",
"example": "ivanov"
},
"first_name": {
"description": "имя",
"type": "string",
"example": "Иван"
},
"last_name": {
"description": "фамилия",
"type": "string",
"example": "Иванов"
},
"avatar": {
"description": "изображение аватара пользователя",
"type": "string",
"example": "/storage/image.jpg"
}
},
"type": "object"
},
"xml": {
"name": "temporary_social_user"
}
},
"schedule": {
"properties": {
"id": {
"description": "id элемента расписания",
"type": "string",
"example": "137279"
},
"title": {
"description": "Название",
"type": "string",
"example": "Золото"
},
"age": {
"description": "Возрастное ограничение",
"type": "string",
"example": "16+"
},
"preview": {
"description": "Превью",
"type": "string",
"example": "http://muz-tv.ru/pic/c/e/ce525ab8b06b7b0a50d2ea9c6de79eac.jpg"
},
"text": {
"description": "Описание",
"type": "string",
"example": "Описание"
},
"start_time": {
"description": "Время начала",
"type": "string",
"example": "1520733600"
},
"onair": {
"type": "string",
"example": false
},
"premiere": {
"type": "string",
"example": true
}
},
"type": "object",
"xml": {
"name": "schedule"
}
},
"news_full": {
"properties": {
"id": {
"description": "id новости",
"type": "string",
"example": "12"
},
"title": {
"description": "Название новости",
"type": "string",
"example": "15 лучших песен Jah Khalib’а"
},
"anons": {
"description": "Анонс новости",
"type": "string",
"example": "Плейлист ко дню рождения артиста"
},
"preview": {
"description": "Картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/a/da4562171b61e69a4ac1eefb55fcd8a3.jpg"
},
"preview_big": {
"description": "Большая картинка",
"type": "string",
"example": "http://muz-tv.ru/pic/d/b/da456dsadasdsfdgfrehcs454543232.jpg"
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": "7"
},
"pubdate": {
"description": "Дата публикации",
"type": "string",
"example": "2016-07-03 11:32:02"
},
"star_ids": {
"description": "id звезд",
"type": "array",
"items": {
"example": "25287, 21421"
}
},
"topic_id": {
"description": "Идентификатор темы комментариев, если тема не существует, то перед добавлением первого комментария её надо создать",
"type": "string",
"example": "13483"
},
"text": {
"description": "Полный текст новости",
"type": "string",
"example": "13483"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "123123"
},
"visits": {
"description": "Количество просмотров",
"type": "string",
"example": "89"
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "694"
},
"images": {
"description": "массив ссылок на картинки",
"type": "array",
"items": {},
"example": [
"https://muz-tv.ru/storage/images/uploaded/1TM9FE1MtF744xalOUK3L6gK7n3wq0Tybcs2Yjff.jpeg",
"https://muz-tv.ru/storage/images/uploaded/1TM9FE1MtF744xalOUK3L6gK7n3wq0Tybcs2Yjff.jpeg"
]
},
"videos": {
"description": "массив ссылок на видео",
"type": "array",
"items": {},
"example": [
"https://....",
"https://...."
]
},
"tags": {
"description": "массив тэгов",
"type": "array",
"items": {},
"example": [
"ololo",
"trololo"
]
}
},
"type": "object",
"xml": {
"name": "news_full"
}
},
"chart": {
"properties": {
"id": {
"description": "id чарта",
"type": "string",
"example": "1280"
},
"title": {
"description": "Название чарта",
"type": "string",
"example": "МУЗ-ТВ Чарт"
},
"chart_type": {
"description": "Идентификатор типа чарта",
"type": "string",
"example": "5"
},
"tracks": {
"$ref": "#/components/schemas/tracks"
}
},
"type": "object",
"xml": {
"name": "chart"
}
},
"tracks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/track"
},
"xml": {
"name": "tracks"
}
},
"track": {
"properties": {
"id": {
"description": "id трека",
"type": "string",
"example": "44601"
},
"title_track": {
"description": "Название трека",
"type": "string",
"example": "Розовое вино"
},
"title_star": {
"description": "Имя исполнителя",
"type": "string",
"example": "FEDUK FEAT. ЭЛДЖЕЙ"
},
"preview": {
"description": "Превью трека",
"type": "string",
"example": "http://muz-tv.ru/pic/6/4/64133e1a905ab5b50a581187c17baea2.jpg"
},
"eagle_id": {
"description": "id в сервисе Eagle Platform",
"type": "string",
"example": ""
},
"youtube_id": {
"description": "id в сервисе YouTube",
"type": "string",
"example": "wOBnq0Ewz5k"
},
"vimeo_id": {
"description": "id в сервисе Vimeo",
"type": "string",
"example": ""
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "72"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "30"
}
},
"type": "object",
"xml": {
"name": "track"
}
},
"charts": {
"type": "array",
"items": {
"$ref": "#/components/schemas/chart"
},
"xml": {
"name": "charts"
}
},
"last_week_charts": {
"properties": {
"title": {
"description": "Название чарта",
"type": "string",
"example": "МУЗ-ТВ Чарт"
},
"id": {
"description": "id чарта",
"type": "string",
"example": "1280"
},
"chart_type": {
"description": "Идентификатор типа чарта",
"type": "string",
"example": "5"
},
"last_week": {
"$ref": "#/components/schemas/tracks"
}
},
"type": "object",
"xml": {
"name": "last_week_charts"
}
},
"project": {
"properties": {
"id": {
"description": "Идентификатор проекта",
"type": "string",
"example": "843"
},
"video_folder_id": {
"description": "Идентификатор папки",
"type": "string",
"example": "843"
},
"title": {
"description": "Название папки",
"type": "string",
"example": "Стилистика"
},
"description": {
"description": "Анонс",
"type": "string",
"example": "Выпуски программы Стилистика"
},
"preview": {
"description": "Превью",
"type": "string",
"example": "http://muz-tv.ru/pic/video/4/b/4bd39daee6e7f413bedb102601b93678.jpg"
},
"preview_mobile": {
"description": "Превью для мобильных",
"type": "string",
"example": "http://muz-tv.ru/pic/0/8/088212f076088099c1e1eceafe371b3e.jpg"
},
"videos_count": {
"description": "Количество видео",
"type": "string",
"example": "119"
},
"last_video_pubdate": {
"description": "Время публикации последнего видео",
"type": "string",
"example": "2012-09-17 14:23:03"
}
},
"type": "object",
"xml": {
"name": "project"
}
},
"profile": {
"description": "Профиль пользователя\nв версии 1.2 добавлены поля verified, new_email",
"type": "array",
"items": {
"properties": {
"id": {
"type": "string",
"example": "1"
},
"oid": {
"type": "string",
"example": "1"
},
"name": {
"description": "никнейм",
"type": "string",
"example": "ivanov"
},
"first_name": {
"description": "имя",
"type": "string",
"example": "Иван"
},
"last_name": {
"description": "фамилия",
"type": "string",
"example": "Иванов"
},
"email": {
"description": "почтовый ящик",
"type": "string",
"example": "ivanov@mail.ru"
},
"new_email": {
"description": "новый почтовый ящик, ждущий подтверждений",
"type": "string",
"example": "ivanov@mail.ru"
},
"verified": {
"description": "флаг подтвержденной почты",
"type": "integer",
"example": "1"
},
"city": {
"description": "город",
"type": "string",
"example": "Москва"
},
"gender": {
"description": "пол: 0 - неопределенный, 1 - мужской, 2 - женский",
"type": "integer",
"example": 0
},
"birthday": {
"description": "дата рождения",
"type": "string",
"example": "1988-03-15"
},
"phone": {
"description": "телефон",
"type": "string",
"example": "89239111272"
},
"last_visit": {
"description": "дата последнего визита",
"type": "string",
"example": "21 12 2017"
},
"avatar": {
"description": "изображение аватара пользователя",
"type": "string",
"example": "/storage/image.jpg"
},
"isAdmin": {
"description": "пользователь — админ",
"type": "bool",
"example": "true"
}
},
"type": "object"
},
"xml": {
"name": "profile"
}
},
"videos": {
"properties": {
"id": {
"description": "Идентификатор видео",
"type": "string",
"example": "9179"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "5"
},
"folder_id": {
"description": "Идентификатор папки",
"type": "string",
"example": "843"
},
"title": {
"description": "Название видео",
"type": "string",
"example": "СТИЛИСТИКА: новости моды, выпуск от 15 июля 2012"
},
"anons": {
"description": "Анонс",
"type": "string",
"example": "Выпуски программы Стилистика"
},
"preview": {
"description": "Превью",
"type": "string",
"example": "http://muz-tv.ru/pic/video/4/b/4bd39daee6e7f413bedb102601b93678.jpg"
},
"image_big": {
"description": "Большое изображение",
"type": "string",
"example": "http://muz-tv.ru/pic/0/8/088212f076088099c1e1eceafe371b3e.jpg"
},
"pubdate": {
"description": "Дата публикации",
"type": "string",
"example": "2012-07-16 13:40:42"
},
"duration": {
"description": "Длительность видео",
"type": "string",
"example": "1380"
},
"topic_id": {
"description": "Идентификатор темы комментариев",
"type": "string",
"example": ""
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": ""
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "24"
}
},
"type": "object",
"xml": {
"name": "videos"
}
},
"video": {
"properties": {
"id": {
"description": "Идентификатор видео",
"type": "string",
"example": "9179"
},
"title": {
"description": "Название видео",
"type": "string",
"example": "СТИЛИСТИКА: новости моды, выпуск от 15 июля 2012"
},
"anons": {
"description": "Анонс",
"type": "string",
"example": "Выпуски программы Стилистика"
},
"duration": {
"description": "Длительность видео",
"type": "string",
"example": "1380"
},
"folder_id": {
"description": "Идентификатор папки",
"type": "string",
"example": "843"
},
"preview": {
"description": "Превью",
"type": "string",
"example": "http://muz-tv.ru/pic/video/4/b/4bd39daee6e7f413bedb102601b93678.jpg"
},
"image_big": {
"description": "Большое изображение",
"type": "string",
"example": "http://muz-tv.ru/pic/0/8/088212f076088099c1e1eceafe371b3e.jpg"
},
"sourceId": {
"description": "Идентификатор источника",
"type": "string",
"example": "1WkM0GUEXUc"
},
"sourceEmbedUrl": {
"description": "Ссылка на втраиваемое видео",
"type": "string",
"example": "http://www.youtube.com/embed/1WkM0GUEXUc"
},
"sourceType": {
"description": "Источник",
"type": "string",
"example": "youtube"
},
"pubdate": {
"description": "Дата публикации",
"type": "string",
"example": "2012-07-16 13:40:42"
},
"topic_id": {
"description": "Идентификатор темы комментариев",
"type": "string",
"example": ""
},
"comments_count": {
"description": "Количество комментариев",
"type": "string",
"example": ""
},
"votes_sum": {
"description": "Количество лайков",
"type": "string",
"example": "24"
},
"entity_type_id": {
"description": "Идентификатор типа сущности",
"type": "string",
"example": "5"
}
},
"type": "object",
"xml": {
"name": "video"
}
},
"folders": {
"properties": {
"id": {
"description": "Идентификатор папки",
"type": "string",
"example": "836"
},
"title": {
"description": "Название папки",
"type": "string",
"example": "Программы МУЗ-ТВ"
},
"anons": {
"description": "Анонс",
"type": "string",
"example": ""
}
},
"type": "object",
"xml": {
"name": "folders"
}
},
"video_folders": {
"properties": {
"id": {
"description": "Идентификатор папки",
"type": "string",
"example": "843"
},
"title": {
"description": "Название папки",
"type": "string",
"example": "Стилистика"
},
"anons": {
"description": "Анонс",
"type": "string",
"example": "Выпуски программы Стилистика"
},
"preview": {
"description": "Превью",
"type": "string",
"example": "http://muz-tv.ru/pic/video/4/b/4bd39daee6e7f413bedb102601b93678.jpg"
},
"image_big": {
"description": "Большое изображение",
"type": "string",
"example": "http://muz-tv.ru/pic/0/8/088212f076088099c1e1eceafe371b3e.jpg"
},
"videos_count": {
"description": "Количество видео",
"type": "string",
"example": "119"
},
"last_video_pubdate": {
"description": "Время публикации последнего видео",
"type": "string",
"example": "2012-09-17 14:23:03"
}
},
"type": "object",
"xml": {
"name": "video_folders"
}
}
},
"parameters": {
"User-Authorization": {
"name": "User-Authorization",
"in": "header",
"description": "Действующий токен доступа",
"required": true,
"schema": {
"type": "string",
"default": "key=123"
}
},
"client_id": {
"name": "client_id",
"in": "query",
"description": "id клиента",
"required": true,
"schema": {
"type": "string"
}
},
"client_secret": {
"name": "client_secret",
"in": "query",
"description": "секретный ключ клиента",
"required": true,
"schema": {
"type": "string"
}
},
"v": {
"name": "v",
"in": "query",
"description": "версия",
"required": true,
"schema": {
"type": "string",
"enum": [
"1.1"
]
}
},
"sig": {
"name": "sig",
"in": "query",
"description": "сигнатура, md5_hex(vid + params + client_secret)",
"schema": {
"type": "string",
"default": "123"
}
},
"Cookie": {
"name": "Cookie",
"in": "header",
"description": "Установка cookie для запроса, формат session={session_key};vid={vid_key};",
"required": true,
"schema": {
"type": "string"
}
},
"host": {
"name": "host",
"in": "query",
"description": "Хост api",
"required": true,
"schema": {
"type": "string",
"enum": [
"muz-tv.ru",
"test.nemuz-tv.ru"
]
}
},
"o": {
"name": "o",
"in": "query",
"description": "Направление сортировки, asc или desc",
"schema": {
"type": "string",
"default": "desc"
}
},
"sing_with_star": {
"name": "sing_with_star",
"in": "query",
"description": "Выдача треков только с флагом sing_with_star",
"schema": {
"type": "string",
"default": "0"
}
}
},
"requestBodies": {
"ChartVote": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"track_id": {
"description": "Идентификаторы треков чарта",
"type": "string"
}
},
"type": "object"
}
}
}
},
"AddComment": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"entity_type": {
"description": "Идентификатор типа сущности",
"type": "string"
},
"entity_id": {
"description": "Идентификатор самой сущности, например идентификатор звезды",
"type": "string"
},
"content": {
"description": "Текст комментария, нужно отсылать в теле запроса",
"type": "string"
},
"comment_id": {
"description": "Идентификатор комментария, присылается в случае добавления ответа на существующий комментарий",
"type": "string"
}
},
"type": "object"
}
}
}
},
"EmojiVote": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"clip_card_id": {
"description": "id клипа",
"type": "integer"
},
"emoji_id": {
"description": "id эмодзи",
"type": "integer"
},
"uuid": {
"description": "Уникальный идентификатор устройства",
"type": "string"
}
},
"type": "object"
}
}
}
},
"CurentEmojiVote": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"clip_card_id": {
"description": "id клипа",
"type": "integer"
},
"emoji_id": {
"description": "id эмодзи",
"type": "integer"
},
"uuid": {
"description": "Уникальный идентификатор устройства",
"type": "string"
},
"date": {
"description": "локальная дата и время пользователя, например 2019-10-23 17:18:00",
"type": "string"
}
},
"type": "object"
}
}
}
},
"GetToken": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"device_id": {
"description": "идентификатор устройства",
"type": "string"
},
"device_type": {
"description": "тип устройства (1-ios, 2-android)",
"type": "integer"
},
"email": {
"description": "почтовый ящик",
"type": "string"
},
"password": {
"description": "пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"Register": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"device_id": {
"description": "идентификатор устройства",
"type": "string"
},
"device_type": {
"description": "тип устройства (1-ios, 2-android)",
"type": "integer"
},
"email": {
"description": "почтовый ящик",
"type": "string"
},
"name": {
"description": "никнейм (поле Ваше имя)",
"type": "string"
},
"password": {
"description": "пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"RegisterSocial": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"email": {
"description": "почтовый ящик",
"type": "string"
}
},
"type": "object"
}
}
}
},
"UpdateUser": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"email": {
"description": "почтовый ящик",
"type": "string"
},
"name": {
"description": "никнейм (поле Ваше имя)",
"type": "string"
},
"first_name": {
"description": "Имя",
"type": "string"
},
"last_name": {
"description": "Фамилия",
"type": "string"
},
"phone": {
"description": "телефон",
"type": "string"
},
"city": {
"description": "город",
"type": "string"
},
"gender": {
"description": "пол (м - 1, ж - 2)",
"type": "integer"
},
"birthday": {
"description": "день рождения (YYYY-MM-DD)",
"type": "string"
},
"password": {
"description": "новый пароль",
"type": "string"
}
},
"type": "object"
}
}
}
},
"ImageStore": {
"required": false,
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"preview": {
"description": "Картинка-исходник (форматы: png,jpeg,gif, минимальные размеры: 1200x628)",
"type": "file"
}
},
"type": "object"
}
}
}
},
"ImageUpdate": {}
}
}
}