API tools faq
paste
Advertisement
Guest User

Swagger-Черновик

a guest
Mar 6th, 2017
194
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
YAML 217.63 KB | None | 0 0
raw download clone embed print report
  1. ---
  2. swagger: '2.0'
  3.  
  4. ################################################################################
  5. #                              API Information                                 #
  6. ################################################################################
  7. info:
  8.   version: "2.0.0"
  9.   title: Lamuz API
  10.  
  11.  
  12. ################################################################################
  13. #                  Host, Base Path, Schemes and Content Types                  #
  14. ################################################################################
  15. host: beta.lamuz.uz
  16. basePath: /v2
  17. schemes:
  18.   - http
  19. consumes:
  20.  - application/json
  21.   - application/form-data
  22. produces:
  23.  - application/json
  24.  
  25. ################################################################################
  26. #                                  Security                                    #
  27. ################################################################################
  28. security:
  29.   - Bearer: []
  30.    
  31. ################################################################################
  32. #                                     Paths                                    #
  33. ################################################################################
  34. paths:
  36. #               ====================  USER  ====================
  37.          
  38.   /users/me:
  39.     get:
  40.       security:
  41.         - Bearer: []
  42.       tags:
  43.         - user
  44.       summary: Получить токен пользователя (Bearer)
  45.       consumes:
  46.        - application/json
  47.       description: |
  48.        Этот метод используется для получения гостевого токена или для того чтобы узнать детали пользователя передав token
  49.         ##### Сценарии
  50.         Запрос работает по двум сценариям
  51.         1. Без заголовка авторизации. В этом случае вернется гостевой аккаунт
  52.         2. С заголовком авторизации. В этом случае вернется аккаунт пользователя
  53.         или гостевой аккаунт, если токен пользователя истек.
  54.        
  55.         ##### ВНИМАНИЕ!
  56.         Токен пользователя может измениться. Это нужно учитывать при
  57.         обработке запроса.
  58.       parameters:
  59.         - $ref: '#/parameters/X-Make'
  60.         - $ref: '#/parameters/X-Model'
  61.         - $ref: '#/parameters/X-Platform'
  62.         - $ref: '#/parameters/X-Platform-Version'
  63.       responses:
  64.         200:
  65.           description: Модель пользователя и `token` сессии
  66.           schema:
  67.             type: object
  68.             title: User model
  69.             properties:
  70.               data:
  71.                 $ref: '#/definitions/User'
  72.  
  73.   /users/signup:
  74.     post:
  75.       tags:
  76.      - user
  77.       summary: Регистрация НОВОГО пользователя с E-mail и логин
  78.       description: В данном запросе мы регистрируем нового пользователя.
  79.       parameters:
  80.         - $ref: '#/parameters/X-Make'
  81.         - $ref: '#/parameters/X-Model'
  82.         - $ref: '#/parameters/X-Platform'
  83.         - $ref: '#/parameters/X-Platform-Version'
  84.         - in: body
  85.           name: User-info
  86.           description: Логин и пароль пользователя
  87.           required: true
  88.           schema:
  89.             $ref: "#/definitions/User-credentials-signup"
  90.       responses:
  91.         200:
  92.           description: Модель пользователя и `token` сессии
  93.           schema:
  94.             type: object
  95.             title: User model
  96.             properties:
  97.               data:
  98.                 $ref: '#/definitions/User'
  99.         422:
  100.           description: Unproccesable entity
  101.           schema:
  102.             type: object
  103.             title: Error model
  104.             properties:
  105.               data:
  106.                 $ref: '#/definitions/Error-response'
  107.                
  108.   /users/signin:
  109.     post:
  110.       tags:
  111.      - user
  112.       summary: Авторизация через логин и пароль
  113.       parameters:
  114.         - $ref: '#/parameters/X-Make'
  115.         - $ref: '#/parameters/X-Model'
  116.         - $ref: '#/parameters/X-Platform'
  117.         - $ref: '#/parameters/X-Platform-Version'
  118.         - in: body
  119.           name: Credentials
  120.           description: Ввод логина и пароля пользователя для авторизации в приложении
  121.           required: true
  122.           schema:
  123.             $ref: "#/definitions/User-credentials-login"
  124.       responses:
  125.         200:
  126.           description: Модель пользователя, `token` сессии и права пользователя
  127.           schema:
  128.             type: object
  129.             title: User model
  130.             properties:
  131.               data:
  132.                 $ref: '#/definitions/User'
  133.         422:
  134.           description: Unproccesable entity
  135.           schema:
  136.             type: object
  137.             title: Error model
  138.             properties:
  139.               data:
  140.                 $ref: '#/definitions/Error-response'
  141.  
  142.   /users/social:
  143.     post:
  144.       tags:
  145.        - user
  146.       summary: Войти или зарегистрироватся с помощью соц аккаунта
  147.       description: Для облегчения входа систему есть возможность зайти в систему через соц сети. Для этого необходимо отправить нижеуказанные данные. Если пользователь уже есть в системе то просто авторизуется в ином случае создается учетная запись пользователю  
  148.       parameters:
  149.         - $ref: '#/parameters/X-Make'
  150.         - $ref: '#/parameters/X-Model'
  151.         - $ref: '#/parameters/X-Platform'
  152.         - $ref: '#/parameters/X-Platform-Version'
  153.         - in: body
  154.           name: Social-Info
  155.           description: Социальные данные пользователя
  156.           required: true
  157.           schema:
  158.             $ref: "#/definitions/User-credentials-oAuth"
  159.       responses:
  160.         200:
  161.           description: Модель пользователя, `token` сессии и права пользователя
  162.           schema:
  163.             type: object
  164.             title: User model
  165.             properties:
  166.               data:
  167.                 $ref: '#/definitions/User'
  168.         422:
  169.           description: Unproccesable entity
  170.           schema:
  171.             type: object
  172.             title: Error model
  173.             properties:
  174.               data:
  175.                 $ref: '#/definitions/Error-response'
  176.  
  177.   /users/signout:
  178.     get:
  179.       security:
  180.         - Bearer: []
  181.       tags:
  182.         - user
  183.       summary: (СЕЙЧАС НЕ РАБОТАЕТ ЗАПРОС) Выйти из аккаунта пользователя
  184.       consumes:
  185.        - application/json
  186.       description: |
  187.        В данном запросе мы делаем logout из аккаунта пользователя Lamuz. Ппредварительно НЕОБХОДИМО авторизоваться в аккаунте и получить токен. затем мы используем этот токен для процедуры выхода из аккаунта
  188.       parameters:
  189.         - $ref: '#/parameters/X-Make'
  190.         - $ref: '#/parameters/X-Model'
  191.         - $ref: '#/parameters/X-Platform'
  192.         - $ref: '#/parameters/X-Platform-Version'
  193.         - in: body
  194.           name: Credentials
  195.           description: Ввод логина и пароля пользователя для выхода из аккаунта
  196.           required: true
  197.           schema:
  198.             $ref: "#/definitions/User-credentials-logout"
  199.       responses:
  200.         200:
  201.           description: успешно выходим из аккаунта пользователя
  202.  
  203.   /users/email:
  204.     post:
  205.       security:
  206.         - Bearer: []
  207.       tags:
  208.        - user
  209.       summary: Запрос на повторную отправку email.
  210.       description: Как пример указан логина testlamuz "http://dashboard.lamuz.uz/#/users/update/5a56ecf2-bbce-66c5-d72e-9023a8a11b49/profile" на продашн сервере. При тесте почта придет по адресу testlamuz@mailinator.com
  211.       parameters:
  212.         - in: body
  213.           name: Type
  214.           description: Тело запроса
  215.           required: true
  216.           schema:
  217.             $ref: "#/definitions/User-resend-email"  
  218.       responses:
  219.         200:
  220.           description: возвращает просто true ))
  221.          
  222.   /users/activation:
  223.     get:
  224.       tags:
  225.        - user
  226.       summary: активация аккаунта через получаемый E-mail
  227.       parameters:
  228.         - in: query
  229.           type: string
  230.           name: "code"
  231.           required: true
  232.           description: "код активации, который можно вытащить только двумя способами. напрямую с письма почты через просмотрение кода или же с сервера"
  233.       responses:
  234.         204:
  235.           description: открывается окно в браузере, в котором показывает текст о том, что активация прошла успешно. Пример (Активация прошла успешно!)
  236.         404:
  237.           description: сервер не сохранил сгенерированный код или ещё что-то. Пример (Ой! Что-то пошло не так!)
  238.          
  239.   /users/recovery:
  240.     get:
  241.       tags:
  242.        - user
  243.       summary: Восстановление пароля
  244.       description: Внимание - работает асинхронно!!! Этот метод находит почту у логина(пользователь) и отправляет ПИН код для восстановления пароля. Если конечно в системе есть такой логин(пользователь). В старом приложении отсутвовал ввод email при регистрации, в связи с этим у некоторых пользователей (логина) может отсустовать email, в этом случае клиентские приложения должны написать в службу поддержки.
  245.       parameters:
  246.         - in: query
  247.           type: string
  248.           name: email
  249.           default: c0e1r0w1o4m3d7i2@lamuz.slack.com
  250.           description: Почтовый адрес канала "#content" в slack
  251.         - in: query
  252.           type: string
  253.           name: login
  254.           default: test
  255.           description: Login пользователя с почтой канала "#content" в slack
  256.       responses:
  257.         200:
  258.           description: Пользователь существует
  259.           schema:
  260.             type: object
  261.             title: User model
  262.             properties:
  263.               data:
  264.                 $ref: '#/definitions/User-recovery-type'
  265.         404:
  266.           description: Почта или логин не найдена
  267.          
  268.   /users/exist:
  269.     get:
  270.       tags:
  271.        - user
  272.       summary: Проверить, доступен ли логин и e-mail в системе (удалить login или e-mail)
  273.       parameters:
  274.         - $ref: '#/parameters/X-Make'
  275.         - $ref: '#/parameters/X-Model'
  276.         - $ref: '#/parameters/X-Platform'
  277.         - $ref: '#/parameters/X-Platform-Version'
  278.         - in: query
  279.           type: string
  280.           required: false
  281.           name: login
  282.           default: davronuz
  283.           description: login или email
  284.         - in: query
  285.           type: string
  286.           required: false
  287.           name: email
  288.           default: davronuz@bk.ru
  289.           description: login или email
  290.       responses:
  291.         200:
  292.           description: Проверяет доступность логина (т.е. не занят ли он)
  293.  
  294.   /users/pin:
  295.     get:
  296.       tags:
  297.        - user
  298.       summary: Проверка полученного ПИН кода при восстановлении пароля
  299.       parameters:
  300.         - $ref: '#/parameters/X-Make'
  301.         - $ref: '#/parameters/X-Model'
  302.         - $ref: '#/parameters/X-Platform'
  303.         - $ref: '#/parameters/X-Platform-Version'
  304.         - in: query
  305.           type: string
  306.           required: false
  307.           name: login
  308.           default: test
  309.           description: login или email
  310.         - in: query
  311.           type: string
  312.           required: false
  313.           name: email
  314.           default: c0e1r0w1o4m3d7i2@lamuz.slack.com
  315.           description: login или email
  316.         - in: query
  317.           description: "ПИН код отправленный на email или  телефон, длина от 4 до 6 цифр"
  318.           type: string
  319.           required: true
  320.           name: pin
  321.           default: "1234"
  322.       responses:
  323.         200:
  324.           description: возвращает лист треков внутри альбома
  325.         404:
  326.           description: если ПИН не найден
  327.         422:
  328.           description: Invalid entity parameters
  329.           schema:
  330.             type: object
  331.             title: Error model
  332.             properties:
  333.               data:
  334.                 $ref: '#/definitions/Error-response'
  335.            
  336.   /users/{user_id}:
  337.     get:
  338.       tags:
  339.        - user
  340.       summary: Получить данные юзера
  341.       description: данный запрос возвращает информацию данного пользователя (песни, плейлисты, исполнители, альбомы)
  342.       parameters:
  343.         - in: path
  344.           type: string
  345.           name: user_id
  346.           required: true
  347.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  348.           description: ID пользователя - как пример указан ID Ярослава
  349.       responses:
  350.         200:
  351.           description: Возвращается информация о пользователе
  352.           schema:
  353.             type: object
  354.             title: User model
  355.             properties:
  356.               data:
  357.                 $ref: '#/definitions/User'
  358.                
  359.   /users/{user_id}/profile:
  360.     put:
  361.       security:
  362.         - Bearer: []
  363.       tags:
  364.        - user
  365.       summary: Обновление данных пользователя
  366.       description: |
  367.         Обновление, редактирование данных пользователя с последующим сохранением.
  368.         > Внимание - отправляемый токен должен принадлежать пользователю с правами модератора. гость не может редактировать!
  369.       parameters:
  370.         - in: path
  371.           type: string
  372.           name: user_id
  373.           description: ID пользователя которому надо обновить данные
  374.           required: true
  375.           default: "b1d01fad-2dc4-d7f9-746c-bd9285cb5cd9"
  376.         - in: body
  377.           name: Обновленные данные профиля
  378.           description: Данные пользователя в личном кабинете
  379.           required: true
  380.           schema:
  381.             $ref: "#/definitions/User-credentials-profile"
  382.       responses:
  383.         200:
  384.           description: Модель пользователя и `token` сессии
  385.           schema:
  386.             type: object
  387.             title: User model
  388.             properties:
  389.               data:
  390.                 $ref: '#/definitions/User'
  391.  
  392.   /users/permission:
  393.     get:
  394.       security:
  395.         - Bearer: []
  396.       tags:
  397.        - user
  398.       summary: Вернуть список ролей и разрешений
  399.       description: |
  400.         Данный запрос возвращает нам массив с ролями и разрешениями из БД
  401.         > Внимание - отправляемый токен должен принадлежать пользователю с правами модератора/администратора
  402.       parameters:
  403.         - $ref: '#/parameters/X-Make'
  404.         - $ref: '#/parameters/X-Model'
  405.         - $ref: '#/parameters/X-Platform'
  406.         - $ref: '#/parameters/X-Platform-Version'
  407.       responses:
  408.         200:
  409.           description: Возвращение массива ролей и разрешений в Lamuz
  410.           schema:
  411.             type: object
  412.             title: Roles and Permission models
  413.             properties:
  414.               data:
  415.                 $ref: '#/definitions/Role-with-Permission'
  416.  
  417.   /users/permission/permission:
  418.     get:
  419.       security:
  420.         - Bearer: []
  421.       tags:
  422.        - user
  423.       summary: Вернуть СПИСОК разрешений
  424.       description: |
  425.         Данный запрос возвращает нам информацию о ролях и информацию о каждом действии из БД
  426.         > Внимание - отправляемый токен должен принадлежать пользователю с правами модератора/администратора
  427.       parameters:
  428.         - $ref: '#/parameters/X-Make'
  429.         - $ref: '#/parameters/X-Model'
  430.         - $ref: '#/parameters/X-Platform'
  431.         - $ref: '#/parameters/X-Platform-Version'
  432.       responses:
  433.         200:
  434.           description: возвращается информация о разрешениях в Lamuz
  435.           schema:
  436.             type: object
  437.             title: Permission models
  438.             properties:
  439.               data:
  440.                 $ref: '#/definitions/Permission'
  441.          
  442.   /users/permission/{user_id}:
  443.     get:
  444.       security:
  445.         - Bearer: []
  446.       tags:
  447.        - user
  448.       summary: Вернуть список ролей у пользователя
  449.       description: |
  450.         Данный запрос возвращает нам список ролей у пользователя из БД
  451.         > Внимание - отправляемый токен должен принадлежать пользователю с правами модератора администратора
  452.       parameters:
  453.         - in: path
  454.           type: string
  455.           name: user_id
  456.           description: ID пользователя у которого мы берём данные (Даврон)
  457.           required: true
  458.           default: "16687b3d-6b99-ec7a-73f6-a55f65f0db07"
  459.         - in: query
  460.           type: string
  461.           name: "expand"
  462.           default: profile, publisherInfo
  463.           description: "Включить в результат profile,+publisherInfo"
  464.       responses:
  465.         200:
  466.           description: Возвращается информация о ролях у пользователя
  467. #         Swagger не распознаёт в *-query* параметре знаки вроде , или +. (есть запрос `get` v2/users/16687b3d-6b99-ec7a-73f6-a55f65f0db07?expand=profile,+publisherInfo) там после `profile` стоит запятая с плюсом. swagger url таким отправляет (v2/users/permission/16687b3d-6b99-ec7a-73f6-a55f65f0db07?expand=profile%2C%20publisherInfo)
  468.  
  469.   /users/password:
  470.     put:
  471.       security:
  472.         - Bearer: []
  473.       tags:
  474.        - user
  475.       summary: Сброс пароля
  476.       description: Сброс пароля для которого необходимо иметь валидный токен для сброса
  477.       parameters:
  478.         - $ref: '#/parameters/X-Make'
  479.         - $ref: '#/parameters/X-Model'
  480.         - $ref: '#/parameters/X-Platform'
  481.         - $ref: '#/parameters/X-Platform-Version'
  482.         - in: body
  483.           name: password
  484.           description: Новый пароль
  485.           required: true
  486.           schema:
  487.             $ref: "#/definitions/User-password-recovery"
  488.       responses:
  489.         200:
  490.           description: Модель пользователя и `token` сессии
  491.           schema:
  492.             type: object
  493.             title: User model
  494.             properties:
  495.               data:
  496.                 $ref: '#/definitions/User'
  497.  
  498.   /users/session:
  499.     get:
  500.       tags:
  501.        - user
  502.       summary: Получить СЕССИИ юзера
  503.       description: Данный запрос возвращает информацию данного пользователя (СЕССИИ)
  504.       parameters:
  505.         - in: query
  506.           type: string
  507.           name: user_id
  508.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  509.           description: ID пользователя - как пример указан ID Ярослава
  510.       responses:
  511.         200:
  512.           description: Возвращается информация о сессиях пользователя
  513.           schema:
  514.             type: object
  515.             title: User session model
  516.             properties:
  517.               data:
  518.                 $ref: '#/definitions/User-sessions-details'
  519.     post:
  520.       security:
  521.         - Bearer: []
  522.       tags:
  523.        - user
  524.       summary: Регистрация токена для push-уведомлений
  525.       description: При помощи данного токена мы можем рассылать push-уведомления пользователям Lamuz.
  526.       parameters:
  527.         - $ref: '#/parameters/X-Make'
  528.         - $ref: '#/parameters/X-Model'
  529.         - $ref: '#/parameters/X-Platform'
  530.         - $ref: '#/parameters/X-Platform-Version'
  531.         - in: body
  532.           name: сredentials
  533.           description: не знаю что тут должно быть
  534.           required: true
  535.           schema:
  536.             $ref: "#/definitions/Session-token-recovery"
  537.       responses:
  538.         200:
  539.           description: Модель пользователя и `token` сессии
  540.  
  541.   /users:
  542.     get:
  543.       security:
  544.         - Bearer: []
  545.       tags:
  546.         - user
  547.       summary: Получить список всех пользователей
  548.       description: |
  549.         Получение списка всех пользователей в базе данных.
  550.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  551.       parameters:
  552.         - in: query
  553.           type: string
  554.           name: "expand"
  555.           required: false
  556.           default: profile
  557.           description: "Включить в результат поиска профили пользователей =profile,"
  558.         - in: query
  559.           type: integer
  560.           name: "limit"
  561.           required: false
  562.           default: 50
  563.           description: "Лимит кол-ва возвращаемого результата"
  564.         - in: query
  565.           type: integer
  566.           format: int32
  567.           name: "page"
  568.           required: false
  569.           default: 1
  570.           description: "Указывает количество страниц"
  571.         - in: query
  572.           type: string
  573.           name: "role"
  574.           required: false
  575.           default: User
  576.           description: "Ключевое слово для поиска пользователей. Если ставить *слово, слово*, *слово*"
  577.       responses:
  578.         200:
  579.           description: Список всех пользователей
  580.  
  581.   /users/{user_id}/likes/albums:
  582.     get:
  583.       security:
  584.         - Bearer: []
  585.       tags:
  586.        - likes
  587.       summary: Показать список лайкнутых альбомов юзера.
  588.       description: В этом запросе возвращается список лайкнутых альбомов
  589.       parameters:
  590.         - in: path
  591.           type: string
  592.           name: user_id
  593.           required: true
  594.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  595.           description: ID пользователя - как пример указан ID Ярослава
  596.       responses:
  597.         200:
  598.           description: Лист с лайкнутыми альбомами
  599.           schema:
  600.             type: object
  601.             title: Детали альбомов
  602.             properties:
  603.               data:
  604.                 $ref: '#/definitions/Album-details'  
  605.  
  606.   /users/{user_id}/likes/songs:
  607.     get:
  608.       security:
  609.         - Bearer: []
  610.       tags:
  611.        - likes
  612.       summary: Показать список лайкнутых треков у юзера.
  613.       description: В этом запросе возвращается список лайкнутых треков
  614.       parameters:
  615.         - in: path
  616.           type: string
  617.           name: user_id
  618.           required: true
  619.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  620.           description: ID пользователя - как пример указан ID Ярослава
  621.       responses:
  622.         200:
  623.           description: Лист лайкнутых треков у пользователя
  624.           schema:
  625.             type: object
  626.             title: Детали альбомов
  627.             properties:
  628.               data:
  629.                 $ref: '#/definitions/Track-details'
  630.                
  631.   /users/{user_id}/likes/artists:
  632.     get:
  633.       security:
  634.         - Bearer: []
  635.       tags:
  636.        - likes
  637.       summary: Показать список лайкнутых исполнителей у юзера.
  638.       description: В этом запросе возвращается список лайкнутых исполнителей
  639.       parameters:
  640.         - in: path
  641.           type: string
  642.           name: user_id
  643.           required: true
  644.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  645.           description: ID пользователя - как пример указан ID Ярослава
  646.       responses:
  647.         200:
  648.           description: Лист лайкнутых исполнителей у пользователя
  649.           schema:
  650.             type: object
  651.             title: Детали альбомов
  652.             properties:
  653.               data:
  654.                 $ref: '#/definitions/Artist-details'
  655.                
  656.   /users/{user_id}/likes/collections:
  657.     get:
  658.       security:
  659.         - Bearer: []
  660.       tags:
  661.        - likes
  662.       summary: Показать список лайкнутых сборников у юзера.
  663.       description: В этом запросе возвращается список лайкнутых сборников
  664.       parameters:
  665.         - in: path
  666.           type: string
  667.           name: user_id
  668.           required: true
  669.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  670.           description: ID пользователя - как пример указан ID Ярослава
  671.       responses:
  672.         200:
  673.           description: Лист лайкнутых сборников у пользователя
  674.           schema:
  675.             type: object
  676.             title: Детали сборника
  677.             properties:
  678.               data:
  679.                 $ref: '#/definitions/Collection-details'
  680.  
  681.   /users/{user_id}/albums:
  682.     get:
  683.       security:
  684.         - Bearer: []
  685.       tags:
  686.        - user
  687.       summary: Показать список альбомов юзера.
  688.       description: В этом запросе возвращается список альбомов пользователя
  689.       parameters:
  690.         - in: path
  691.           type: string
  692.           name: user_id
  693.           required: true
  694.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  695.           description: ID пользователя - как пример указан ID Ярослава
  696.       responses:
  697.         200:
  698.           description: Лист с альбомами пользователя
  699.           schema:
  700.             type: object
  701.             title: Детали альбомов
  702.             properties:
  703.               data:
  704.                 $ref: '#/definitions/Album-details'    
  705. # Данный запрос ничего не возвращает
  706.  
  707.   /users/{user_id}/collections:
  708.     get:
  709.       security:
  710.         - Bearer: []
  711.       tags:
  712.        - user
  713.       summary: Показать список сборников у юзера.
  714.       description: В этом запросе возвращается список сборников gjkmpjdfntkz
  715.       parameters:
  716.         - in: path
  717.           type: string
  718.           name: user_id
  719.           required: true
  720.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  721.           description: ID пользователя - как пример указан ID Ярослава
  722.       responses:
  723.         200:
  724.           description: Лист сборников у пользователя
  725.           schema:
  726.             type: object
  727.             title: Детали сборника
  728.             properties:
  729.               data:
  730.                 $ref: '#/definitions/Collection-details'  
  731. # Данный запрос ничего не возвращает    
  732.  
  733. #               ====================  PUBLISHER  ====================
  734.  
  735.   /publishers/{publisher_id}:
  736.     get:
  737.       security:
  738.         - Bearer: []
  739.       tags:
  740.        - publisher
  741.       summary: Вернуть информацию о издателе
  742.       description: В этом запросе мы получаем информацию о Publisher
  743.       parameters:
  744.         - in: path
  745.           type: string
  746.           name: publisher_id
  747.           required: true
  748.           default: "dbaac40d-ab66-4711-ac9a-af477565f043"
  749.           description: ID паблишера - как пример указан ID LAMUZ MEDIA
  750.       responses:
  751.         200:
  752.           description: Возвращается информация о издателе
  753.           schema:
  754.             type: object
  755.             title: User model
  756.             properties:
  757.               data:
  758.                 $ref: '#/definitions/Publisher'
  759.  
  760.  
  761.          
  762. #               ====================  SEARCH  ====================
  763.  
  764.   /search/playlists:
  765.     get:
  766.       security:
  767.         - Bearer: []
  768.       tags:
  769.        - search
  770.       summary: Поиск и фильтрация альбомов\плейлистов
  771.       description: |
  772.        В этом поиске мы рассматриваем просмотр пользовательских плейлистов, а также можем просмотреть (новинки/топ-плейлисты/топ-исполнителей/последнее загруженное)
  773.       parameters:
  774.         - in: query
  775.           type: string
  776.           name: user_id
  777.           required: false
  778.           default: "4e913b1c-842a-4d94-86c8-936923330790"
  779.           description: ID пользователя - как пример указан ID Ярослава
  780.         - in: query
  781.           type: array
  782.           items:
  783.             type: integer
  784.             format: int32
  785.             default: 1
  786.           collectionFormat: multi
  787.           name: "type[]"
  788.           required: false
  789.           description: "Что именно надо вернуть? 1=Плейлист пользователя, 2=Альбом исполнителя, 3=Сборник, 4=Системный плейлист, 5=Сингл"
  790.         - in: query
  791.           type: array
  792.           items:
  793.             type: string
  794.             default: "099385e1-57f8-41b2-90a7-8e55bc67d26e"
  795.           collectionFormat: multi
  796.           name: "genre_id[]"
  797.           required: false
  798.           description: "http://dashboard.lamuz.uz/#/library/genres - по этому url доступен весь список жанров"
  799.         - in: query
  800.           type: string
  801.           name: "name"
  802.           required: false
  803.           default: "*alb*"
  804.           description: "Ключевое слово для поиска плейлиста. Если ставить *слово, слово*, *слово*"
  805.         - in: query
  806.           type: string
  807.           name: "expand"
  808.           required: false
  809.           default: artists
  810.           description: "Включить в результат поиска исполнителя=artists,"
  811.         - in: query
  812.           type: string
  813.           name: "sort"
  814.           required: false
  815.           default: -likes
  816.           description: "Сортировка результата плейлистов по -likes-, -updated_at-, -created_at-, -released_at-  (минус в концовке работает не верно)"
  817.       responses:
  818.         200:
  819.           description: Возвращает список плейлистов пользователя (также можно просмотреть новинки/топ-плейлисты/топ-исполнителей/последнее загруженное)
  820.  
  821.   /search/songs:
  822.     get:
  823.       security:
  824.         - Bearer: []
  825.       tags:
  826.        - search
  827.       summary: Поиск и фильтрация треков
  828.       description: В этом поиске мы рассматриваем поиск всех треков в системе
  829.       parameters:
  830.         - in: query
  831.           type: string
  832.           name: title
  833.           required: false
  834.           default: "hayol*"
  835.           description: Ключевое слово для поиска трека. Звездочка означает курсор, откуда начать поиск *трек, трек*, *трек*
  836.         - in: query
  837.           type: string
  838.           name: "expand"
  839.           required: false
  840.           default: artists
  841.           description: "Включить в результат поиска albums, genre, regions"
  842.         - in: query
  843.           type: integer
  844.           name: "limit"
  845.           required: false
  846.           default: 50
  847.           description: "Лимит кол-во возвращаемого результата"
  848.         - in: query
  849.           type: string
  850.           name: "sort"
  851.           required: false
  852.           default: -likes
  853.           description: "Сортировка результата плейлистов по -likes-, -updated_at-, -created_at- (минус в концовке работает не верно)"
  854.       responses:
  855.         200:
  856.           description: Лист с информацией о треке
  857.           schema:
  858.             type: object
  859.             title: Детали трека
  860.             properties:
  861.               data:
  862.                 $ref: '#/definitions/Track-details'
  863.  
  864.   /search/artists:
  865.     get:
  866.       security:
  867.         - Bearer: []
  868.       tags:
  869.        - search
  870.       summary: Поиск и фильтрация исполнителей
  871.       description: В этом поиске мы рассматриваем поиск всех исполнителей в системе
  872.       parameters:
  873.         - in: query
  874.           type: string
  875.           name: name
  876.           required: false
  877.           default: "dado*"
  878.           description: Ключевое слово для поиска Исполнителя. Звездочка означает курсор, откуда начать поиск *иполнитель, исполнитель*, *исполнитель*
  879.         - in: query
  880.           type: integer
  881.           name: "limit"
  882.           required: false
  883.           default: 50
  884.           description: "Лимит кол-во возвращаемого результата"
  885.         - in: query
  886.           type: string
  887.           name: "sort"
  888.           required: false
  889.           default: -created_at
  890.           description: "Сортировка результата плейлистов по -likes-, -updated_at-, -created_at-, (минус в концовке работает не верно)"
  891.       responses:
  892.         200:
  893.           description: Лист с информацией о треке
  894.           schema:
  895.             type: object
  896.             title: Детали трека
  897.             properties:
  898.               data:
  899.                 $ref: '#/definitions/Artist-details'
  900.  
  901. #               ====================  SONG  ====================
  902.          
  903.   /songs:
  904.     get:
  905.       security:
  906.         - Bearer: []
  907.       tags:
  908.        - songs
  909.       summary: Получить список всех песен
  910.       description: |
  911.         Получение списка всех треков в базе данных.
  912.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  913.       parameters:
  914.         - in: query
  915.           type: string
  916.           name: "expand"
  917.           required: false
  918.           default: albums
  919.           description: "Включить в результат запроса =albums,genre,regions"
  920.         - in: query
  921.           type: integer
  922.           name: "limit"
  923.           required: false
  924.           default: 50
  925.           description: "Лимит кол-ва возвращаемого результата"
  926.         - in: query
  927.           type: integer
  928.           format: int32
  929.           name: "status"
  930.           required: false
  931.           default: 1
  932.           description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  933.       responses:
  934.         200:
  935.           description: Возвращает список треков по заданным критериям
  936.           schema:
  937.             type: object
  938.             title: Детали трека
  939.             properties:
  940.               data:
  941.                 $ref: '#/definitions/Track-details'
  942.  
  943.   /songs/{song_id}:
  944.     get:
  945.       security:
  946.         - Bearer: []
  947.       tags:
  948.        - songs
  949.       summary: Получить информацию о композиции
  950.       description: Получить информацию о композиции, чей ID мы указываем в запросе.
  951.       parameters:
  952.         - in: path
  953.           type: string
  954.           name: song_id
  955.           required: true
  956.           description: ID песни - необходимо брать из дашборда/девдаша.
  957.       responses:
  958.         200:
  959.           description: Возвращает всю информацию (которая мы загружали в БД) о композиции
  960.           schema:
  961.             type: object
  962.             title: Детали композиции
  963.             properties:
  964.               data:
  965.                 $ref: '#/definitions/Track-details'
  966.     delete:
  967.       security:
  968.         - Bearer: []
  969.       tags:
  970.        - songs
  971.       summary: Удалить песню
  972.       description: В этом запросе мы удаляем композицию, чей ID мы указываем.
  973.       parameters:
  974.         - in: path
  975.           type: string
  976.           name: song_id
  977.           required: true
  978.           description: ID трека - данный ID присутствует у каждого объекта контента
  979.       responses:
  980.         204:
  981.           description: трек просто удаляется и возвращается пустое body. в ответе вернулось только слово "NOCONTENT"
  982.     put:
  983.       security:
  984.         - Bearer: []
  985.       tags:
  986.        - songs
  987.       summary: Редактировать песню
  988.       description: |
  989.         В данном запросе мы Редактируем композицию.
  990.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  991.       parameters:
  992.         - in: path
  993.           type: string
  994.           name: song_id
  995.           required: true
  996.           default: "89072e61-a0ce-9727-38d7-dc864d6e4edc"
  997.           description: ID трека - данный ID присутствует у каждого объекта контента
  998.         - in: body
  999.           name: Обновленные данные композиции
  1000.           description: Данные композиции
  1001.           required: true
  1002.           schema:
  1003.             $ref: "#/definitions/Track-changes-details"
  1004.       responses:
  1005.         200:
  1006.           description: Изменённая композиция
  1007.         422:
  1008.           description: Ошибка в случае неправильного ввода данных для редактирования трека или если что-то не заполнили
  1009. ###################### в запросе PUT НЕОБХОДИМО ОФОРМИТЬ ТЕЛО JSON ДЛЯ ОТПРАВКИ!!!   ##########################
  1010.  
  1011.   /songs/{song_id}/listen:
  1012.     put:
  1013.       security:
  1014.         - Bearer: []
  1015.       tags:
  1016.        - songs
  1017.       summary: Получить информацию о количестве прослушиваний композиции
  1018.       description: Получить информацию о количестве прослушиваний композиции, чей ID мы указываем в запросе.
  1019.       parameters:
  1020.         - in: path
  1021.           type: string
  1022.           name: song_id
  1023.           required: true
  1024.           description: ID песни - необходимо брать из дашборда/девдаша.
  1025.       responses:
  1026.         200:
  1027.           description: Возвращает всю информацию о прослушиваниях для композиции
  1028.           schema:
  1029.             type: object
  1030.             title: Детали композиции
  1031.             properties:
  1032.               data:
  1033.                 $ref: '#/definitions/Track-details'
  1034. ###################### данный запрос НЕ РАБОТАЕТ!  ##########################
  1035.  
  1036.  
  1037. #               ====================  CATEGORY  ====================  
  1038.  
  1039.   /categories:
  1040.     get:
  1041.       security:
  1042.         - Bearer: []
  1043.       tags:
  1044.        - categories
  1045.       summary: Показать все категории
  1046.       description: Категории это что-то вроде папки где есть разные сборники плейлистов на все настроения и жанры
  1047.       parameters:
  1048.         - in: query
  1049.           type: string
  1050.           name: title
  1051.           required: false
  1052.           description: Ключевое слово для поиска в категориях
  1053.         - in: query
  1054.           type: integer
  1055.           name: "limit"
  1056.           required: false
  1057.           default: 50
  1058.           description: "Лимит кол-ва возвращаемого результата"
  1059.         - in: query
  1060.           type: integer
  1061.           name: "type"
  1062.           required: false
  1063.           default: 2
  1064.           description: "На момент создания этого описания было два типа 1 и 2. Первый виден на первой версии приложения. Второй тип на новой версии приложения"
  1065.       responses:
  1066.         200:
  1067.           description: Список всех категорий
  1068.           schema:
  1069.             type: object
  1070.             title: Детали категорий
  1071.             properties:
  1072.               data:
  1073.                 $ref: '#/definitions/Category-details'
  1074.     post:
  1075.       security:
  1076.         - Bearer: []
  1077.       tags:
  1078.        - categories
  1079.       summary: Создание новой Категории
  1080.       description: |
  1081.         Создание новой КАТЕГОРИИ в базе данных.
  1082.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  1083.       consumes:
  1084.        - multipart/form-data  # and/or application/x-www-form-urlencoded
  1085.       parameters:
  1086.         - in: formData
  1087.           name: id
  1088.           description: Уникальный ID создаваемой Категории.
  1089.           required: false
  1090.           type: string
  1091.         - in: formData
  1092.           name: title
  1093.           description: Заголовок (Главное имя) создаваемой Категории.
  1094.           required: true
  1095.           type: string
  1096.         - in: formData
  1097.           name: position
  1098.           description: Занимаемая позиция создаваемого объекта (Для категории порядковый номер среди других категорий).
  1099.           required: false
  1100.           type: integer
  1101.         - in: formData
  1102.           name: description
  1103.           description: Описание создаваемой Категории.
  1104.           required: false
  1105.           type: string
  1106.         - in: formData
  1107.           name: cover
  1108.           description: Главная картинка создаваемой Категории (используется URL картинки, которую загрузили заранее).
  1109.           required: false
  1110.           type: string
  1111.         - in: formData
  1112.           name: cover_id
  1113.           description: Уникальный ID кавера создаваемой Категории.
  1114.           required: false
  1115.           type: string
  1116.         - in: formData
  1117.           name: icon
  1118.           description: Иконка формата png для создаваемой Категории (используется URL картинки, которую загрузили заранее).
  1119.           required: false
  1120.           type: string
  1121.         - in: formData
  1122.           name: type
  1123.           description: Тип для создаваемой Категории.
  1124.           required: true
  1125.           type: integer
  1126.         - in: formData
  1127.           name: created_at
  1128.           description: Дата создания создаваемой Категории.
  1129.           required: false
  1130.           type: integer
  1131.         - in: formData
  1132.           name: updated_at
  1133.           description: Дата обновления создаваемой Категории.
  1134.           required: false
  1135.           type: integer
  1136.         - in: formData
  1137.           name: image
  1138.           description: Картинка-кавер формата jpeg для создаваемой Категории (используется полное название файла картинки, которую загрузили).
  1139.           required: true
  1140.           type: file
  1141.         - in: formData
  1142.           name: iconImage
  1143.           description: Картинка-иконка формата png для создаваемой Категории (используется полное название файла картинки, которую загрузили).
  1144.           required: true
  1145.           type: file
  1146.       responses:
  1147.         200:
  1148.           description: okay
  1149. ###################### в запросе POST НЕОБХОДИМО ОФОРМИТЬ ПОЛЕ PARAMETERS ДЛЯ ОТПРАВКИ!!!   ##########################  
  1150.  
  1151.   /categories/{category_id}:
  1152.     delete:
  1153.       security:
  1154.         - Bearer: []
  1155.       tags:
  1156.        - categories
  1157.       summary: Удалить категорию
  1158.       description: В этом запросе мы удаляем категорию, чей ID мы указываем.
  1159.       parameters:
  1160.         - in: path
  1161.           type: string
  1162.           name: category_id
  1163.           required: true
  1164.           description: ID категории - данный ID присутствует у каждого объекта контента
  1165.       responses:
  1166.         204:
  1167.           description: Если у Категории не было никакого контента, то он просто удаляется и возвращается пустое body. в ответе вернулось только слово "NOCONTENT"
  1168.          
  1169. #               ====================  GENRES  ====================
  1170.  
  1171.   /genres:
  1172.     get:
  1173.       security:
  1174.         - Bearer: []
  1175.       tags:
  1176.        - genres
  1177.       summary: Показать все жанры
  1178.       description: В данном запросе мы получаем все жанры, используемые в БД и в приложении Lamuz (для треков/альбомов/плейлистов)
  1179.       parameters:
  1180.         - in: query
  1181.           type: integer
  1182.           name: "limit"
  1183.           required: false
  1184.           default: 50
  1185.           description: "Лимит кол-ва возвращаемого результата"
  1186.         - in: query
  1187.           type: string
  1188.           name: "name"
  1189.           description: "название жанра"
  1190.         - in: query
  1191.           type: integer
  1192.           name: "page"
  1193.           required: false
  1194.           default: 1
  1195.           description: "Указывает количество страниц"
  1196.       responses:
  1197.         200:
  1198.           description: "Лист с ЖАНРАМИ"
  1199.           schema:
  1200.             type: object
  1201.             title: Детали жанра
  1202.             properties:
  1203.               data:
  1204.                 $ref: '#/definitions/Genre-details'
  1205.      
  1206. #               ====================  ARTIST  ====================      
  1207.      
  1208.   /artists:
  1209.     get:
  1210.       security:
  1211.         - Bearer: []
  1212.       tags:
  1213.        - artist
  1214.       summary: Получить список всех исполнителей
  1215.       description: |
  1216.         Получение списка всех исполнителей в базе данных.
  1217.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  1218.       parameters:
  1219.         - in: query
  1220.           type: integer
  1221.           name: "limit"
  1222.           required: false
  1223.           default: 50
  1224.           description: "Лимит кол-ва возвращаемого результата"
  1225.         - in: query
  1226.           type: string
  1227.           name: "name"
  1228.           required: false
  1229.           description: Ключевое слово для поиска Исполнителя. Звездочка означает курсор, откуда начать поиск *иполнитель, исполнитель*, *исполнитель*
  1230.         - in: query
  1231.           type: integer
  1232.           format: int32
  1233.           name: "page"
  1234.           required: false
  1235.           default: 1
  1236.           description: "Указывает количество страниц"
  1237.         - in: query
  1238.           type: string
  1239.           name: "sort"
  1240.           required: false
  1241.           default: -created_at
  1242.           description: "Сортировка результата плейлистов по -likes-, -updated_at-, -created_at-, -released_at-  (минус в концовке работает не верно)"
  1243.       responses:
  1244.         200:
  1245.           description: Возвращает список исполнителей по заданным критериям
  1246.           schema:
  1247.             type: object
  1248.             title: Детали трека
  1249.             properties:
  1250.               data:
  1251.                 $ref: '#/definitions/Artist-details'
  1252.     post:
  1253.       security:
  1254.         - Bearer: []
  1255.       tags:
  1256.        - artist
  1257.       summary: Создать исполнителя в базе данных
  1258.       description: |
  1259.         В данном запросе создаём исполнителя в базе данных.
  1260.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора.
  1261.       consumes:
  1262.        - multipart/form-data
  1263.       parameters:
  1264.         - in: formData
  1265.           name: name
  1266.           description: Имя нового Артиста в БД
  1267.           required: true
  1268.           type: string
  1269.         - in: formData
  1270.           name: image
  1271.           description: Картинка нового Артиста в БД
  1272.           type: file
  1273.       responses:
  1274.         201:
  1275.           description: Возвращает информацию по созданному Артисту
  1276.           schema:
  1277.             type: object
  1278.             title: Детали артиста
  1279.             properties:
  1280.               data:
  1281.                 $ref: '#/definitions/Created-Artist-details'
  1282.  
  1283.   /artists/{artist_id}:
  1284.     get:
  1285.       security:
  1286.         - Bearer: []
  1287.       tags:
  1288.        - artist
  1289.       summary: Получить информацию об исполнителе
  1290.       description: Получить инфу об исполнителе (биография, альбомы, синглы, связанные артисты, дуэты), чей ID мы указываем в запросе.
  1291.       parameters:
  1292.         - in: path
  1293.           type: string
  1294.           name: artist_id
  1295.           required: true
  1296.           default: "6e8a82d5-2a60-0112-d51a-ed108a825e15"
  1297.           description: ID артиста - как пример указан ID исполнителя Skrillex
  1298.       responses:
  1299.         200:
  1300.           description: Возвращает всю информацию (которая мы загружали в БД) об исполнителе
  1301.           schema:
  1302.             type: object
  1303.             title: Детали артиста
  1304.             properties:
  1305.               data:
  1306.                 $ref: '#/definitions/Artist-details'
  1307.     delete:
  1308.       security:
  1309.         - Bearer: []
  1310.       tags:
  1311.        - artist
  1312.       summary: Удалить исполнителя
  1313.       description: В данном запросе мы удаляем исполнителя по введёному ID. (у данного исполнителя нет никаких треков, синглов, плейлистов и альбомов)
  1314.       parameters:
  1315.         - in: path
  1316.           type: string
  1317.           name: artist_id
  1318.           required: true
  1319.           description: ID артиста - данный ID присутствует у каждого объекта контента
  1320.       responses:
  1321.         204:
  1322.           description: Если у исполнителя не было никакого контента, то он просто удаляется и возвращается пустое body. в ответе вернулось только слово "NOCONTENT"
  1323.     post:
  1324.       security:
  1325.         - Bearer: []
  1326.       tags:
  1327.        - artist
  1328.       summary: Редактировать данные у артиста
  1329.       description: |
  1330.        В данном запросе мы редактируем информацию у артиста.
  1331.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде! для использования данного запроса необходимо ввести токен модератора
  1332.       parameters:
  1333.         - in: path
  1334.           type: string
  1335.           name: artist_id
  1336.           description: ID артиста которому надо обновить данные
  1337.           required: true
  1338.           default: "9656b1d4-3153-8cc4-5367-72837a030c2b"
  1339.         - in: body
  1340.           name: Обновленные данные Артиста
  1341.           description: отправляем схему для изменений в профиле у артиста
  1342.           required: true
  1343.           schema:
  1344.             $ref: "#/definitions/Artist-edited-profile"
  1345.       responses:
  1346.         200:
  1347.           description: Возвращает всю информацию (которая мы загружали в БД) об исполнителе
  1348.  
  1349.   /artists/{artist_id}/likes:
  1350.     post:
  1351.       security:
  1352.         - Bearer: []
  1353.       tags:
  1354.        - artist
  1355.         - likes
  1356.       summary: Поставить лайк исполнителю
  1357.       description: В данном запросе мы ставим лайк исполнителя по введёному ID.
  1358.       parameters:
  1359.         - in: path
  1360.           type: string
  1361.           name: artist_id
  1362.           description: ID артиста которому ставим лайк
  1363.           required: true
  1364.           default: "7d4b47fb-dd26-ca09-8b64-d1a91085c998"
  1365.         - in: body
  1366.           name: Пустая модель для отметки лайк Артисту
  1367.           description: Отправляем пустую модель для отметки лайк
  1368.           required: true
  1369.           schema:
  1370.             $ref: "#/definitions/Like-for-artist"
  1371.       responses:
  1372.         204:
  1373.           description: Исполнителю добавляется лайк
  1374.     delete:
  1375.       security:
  1376.         - Bearer: []
  1377.       tags:
  1378.        - artist
  1379.         - likes
  1380.       summary: Поставить лайк исполнителю
  1381.       description: В данном запросе мы ставим лайк исполнителя по введёному ID.
  1382.       parameters:
  1383.         - in: path
  1384.           type: string
  1385.           name: artist_id
  1386.           required: true
  1387.           default: "9656b1d4-3153-8cc4-5367-72837a030c2b"
  1388.           description: ID артиста - данный ID присутствует у каждого объекта контента
  1389.       responses:
  1390.         204:
  1391.           description: Исполнителю добавляется лайк
  1392. ###################### в запросах НЕОБХОДИМО ОФОРМИТЬ ПОЛЕ PARAMETERS ДЛЯ ОТПРАВКИ!!!   ##########################                
  1393.  
  1394.   /artists/{artist_id}/albums:
  1395.     get:
  1396.       security:
  1397.         - Bearer: []
  1398.       tags:
  1399.        - artist
  1400.       summary: Показать все альбомы исполнителя.
  1401.       description: В этом запросе возвращается список альбомов исполнителя, чей ID мы указываем.
  1402.       parameters:
  1403.         - in: path
  1404.           type: string
  1405.           name: artist_id
  1406.           required: true
  1407.           default: "6e8a82d5-2a60-0112-d51a-ed108a825e15"
  1408.           description: ID артиста - как пример указан ID исполнителя Skrillex
  1409.       responses:
  1410.         200:
  1411.           description: "Лист с альбомами исполнителя"
  1412.           schema:
  1413.             type: object
  1414.             title: Детали альбомов
  1415.             properties:
  1416.               data:
  1417.                 $ref: '#/definitions/Album-details'
  1418.         404:
  1419.           description: "Not Found"
  1420.           schema:
  1421.             type: object
  1422.             title: Error model
  1423.             properties:
  1424.               data:
  1425.                 $ref: '#/definitions/Error-response'
  1426.                
  1427.   /artists/{artist_id}/songs:
  1428.     get:
  1429.       security:
  1430.         - Bearer: []
  1431.       tags:
  1432.        - artist
  1433.       summary: Показать все "популярные" синглы исполнителя.
  1434.       description: В этом запросе возвращается список "популярных" синглов исполнителя, чей ID мы указываем.
  1435.       parameters:
  1436.         - in: path
  1437.           type: string
  1438.           name: artist_id
  1439.           required: true
  1440.           default: "6e8a82d5-2a60-0112-d51a-ed108a825e15"
  1441.           description: ID артиста - как пример указан ID исполнителя Skrillex
  1442.       responses:
  1443.         200:
  1444.           description: "Лист с популярными синглами исполнителя"
  1445.           schema:
  1446.             type: object
  1447.             title: Детали альбомов
  1448.             properties:
  1449.               data:
  1450.                 $ref: '#/definitions/Track-details'
  1451.         404:
  1452.           description: "Not Found"
  1453.           schema:
  1454.             type: object
  1455.             title: Error model
  1456.             properties:
  1457.               data:
  1458.                 $ref: '#/definitions/Error-response'
  1459.    
  1460.   /artists/{artist_id}/feat:
  1461.     get:
  1462.       security:
  1463.         - Bearer: []
  1464.       tags:
  1465.        - artist
  1466.       summary: Показать все совместные альбомы исполнителя.
  1467.       description: В этом запросе возвращается список совместных альбомов исполнителя, чей ID мы указываем.
  1468.       parameters:
  1469.         - in: path
  1470.           type: string
  1471.           name: artist_id
  1472.           required: true
  1473.           default: "6e8a82d5-2a60-0112-d51a-ed108a825e15"
  1474.           description: ID артиста - как пример указан ID исполнителя Skrillex
  1475.       responses:
  1476.         200:
  1477.           description: "Лист со всеми совместными альбомами исполнителя"
  1478.           schema:
  1479.             type: object
  1480.             title: Детали альбомов
  1481.             properties:
  1482.               data:
  1483.                 $ref: '#/definitions/Track-details'
  1484.         404:
  1485.           description: "Not Found"
  1486.           schema:
  1487.             type: object
  1488.             title: Error model
  1489.             properties:
  1490.               data:
  1491.                 $ref: '#/definitions/Error-response'
  1492.                
  1493.   /artists/{artist_id}/singles:
  1494.     get:
  1495.       security:
  1496.         - Bearer: []
  1497.       tags:
  1498.        - artist
  1499.       summary: Показать все синглы исполнителя.
  1500.       description: В этом запросе возвращается список всех синглов исполнителя, чей ID мы указываем.
  1501.       parameters:
  1502.         - in: path
  1503.           type: string
  1504.           name: artist_id
  1505.           required: true
  1506.           default: "e41ff901-8c09-71ee-1770-a7649defc915"
  1507.           description: ID артиста - как пример указан ID исполнителя MiyaGi
  1508.       responses:
  1509.         200:
  1510.           description: "Лист со всеми синглами исполнителя"
  1511.           schema:
  1512.             type: object
  1513.             title: Детали альбомов
  1514.             properties:
  1515.               data:
  1516.                 $ref: '#/definitions/Track-details'
  1517.         404:
  1518.           description: "Not Found"
  1519.           schema:
  1520.             type: object
  1521.             title: Error model
  1522.             properties:
  1523.               data:
  1524.                 $ref: '#/definitions/Error-response'
  1525.                
  1526.   /artists/{artist_id}/related:
  1527.     get:
  1528.       security:
  1529.         - Bearer: []
  1530.       tags:
  1531.        - artist
  1532.       summary: Показать всех похожих исполнителей у исполнителя, которого мы рассматриваем
  1533.       description: В этом запросе возвращается список всех похожих исполнителей у исполнителя, чей ID мы указываем.
  1534.       parameters:
  1535.         - in: path
  1536.           type: string
  1537.           name: artist_id
  1538.           required: true
  1539.           default: "e41ff901-8c09-71ee-1770-a7649defc915"
  1540.           description: ID артиста - как пример указан ID исполнителя MiyaGi
  1541.       responses:
  1542.         200:
  1543.           description: "Лист со всеми похожими исполнителями"
  1544.           schema:
  1545.             type: object
  1546.             title: Детали альбомов
  1547.             properties:
  1548.               data:
  1549.                 $ref: '#/definitions/Track-details'
  1550.     post:
  1551.       security:
  1552.         - Bearer: []
  1553.       tags:
  1554.        - artist
  1555.       summary: Сохранить список связанных исполнителей
  1556.       description: В этом запросе сохраняется список всех похожих исполнителей у исполнителя, чей ID мы указываем.
  1557.       parameters:
  1558.         - in: path
  1559.           type: string
  1560.           name: artist_id
  1561.           required: true
  1562.           default: "9656b1d4-3153-8cc4-5367-72837a030c2b"
  1563.           description: "ID артиста, к которому необходимо добавить ПОХОЖИХ исполнителей"
  1564.        
  1565.         - in: body
  1566.           name: Похожие исполнители
  1567.           description: отправляем id артистов, которые должны добавиться в раздел Похожих
  1568.           required: true
  1569.           schema:
  1570.             $ref: "#/definitions/Related-Artist-Model"
  1571.       responses:
  1572.         200:
  1573.           description: "Лист со всеми похожими исполнителями"
  1574. #     ====================== Не ЗНАЮ КАК ОФОРМИТЬ ЗАПРОС POST ===================================
  1575.    
  1576. #               ====================  PLAYLIST  ====================                
  1577.                
  1578.   /playlists:
  1579.     get:
  1580.       security:
  1581.         - Bearer: []
  1582.       tags:
  1583.        - playlists
  1584.       summary: Отображение плейлистов внутри Категории
  1585.       description: Возвращает плейлисты в Категории
  1586.       parameters:
  1587.         - in: query
  1588.           type: array
  1589.           items:
  1590.             type: integer
  1591.             format: int32
  1592.             default: 1
  1593.           collectionFormat: multi
  1594.           name: "type[]"
  1595.           required: false
  1596.           description: "Что именно надо вернуть? 1=Плейлист пользователя, 2=Альбом исполнителя, 3=Сборник, 4=Системный плейлист, 5=Сингл"
  1597.         - in: query
  1598.           type: string
  1599.           name: category_id
  1600.           required: false
  1601.           default: "c855eed3-8065-07bf-fd88-908eff2ac13b"
  1602.           description: ID категории - например Dance/EDM
  1603.         - in: query
  1604.           type: string
  1605.           name: "expand"
  1606.           required: false
  1607.           default: artists
  1608.           description: "Включить в результат поиска исполнителя `=artists`"
  1609.         - in: query
  1610.           type: string
  1611.           name: "name"
  1612.           required: false
  1613.           description: "Включить в результат поиска название пользовательского плейлиста `=name`"
  1614.         - in: query
  1615.           type: integer
  1616.           format: int32
  1617.           name: "limit"
  1618.           required: false
  1619.           default: 30
  1620.           description: "Лимит кол-ва возвращаемого результата"
  1621.         - in: query
  1622.           type: integer
  1623.           format: int32
  1624.           name: "page"
  1625.           required: false
  1626.           default: 1
  1627.           description: "Указывает количество страниц внутри Категории"
  1628.         - in: query
  1629.           type: string
  1630.           name: "sort"
  1631.           required: false
  1632.           default: position
  1633.           description: "Сортировка результата плейлистов по `position`"
  1634.         - in: query
  1635.           type: integer
  1636.           format: int32
  1637.           name: status
  1638.           required: false
  1639.           default: 1
  1640.           description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  1641.         - in: query
  1642.           type: string
  1643.           name: "title"
  1644.           required: false
  1645.           description: "Включить в результат поиска заголовок ХЗ ЧЕГО `=title`"
  1646.       responses:
  1647.         200:
  1648.           description: Возвращает список плейлистов внутри категории
  1649.           schema:
  1650.             type: object
  1651.             title: Детали плейлиста
  1652.             properties:
  1653.               data:
  1654.                 $ref: '#/definitions/Playlist-details'
  1655.     post:
  1656.       security:
  1657.         - Bearer: []
  1658.       tags:
  1659.        - playlists
  1660.       summary: Создать плейлист в зависимости от типа в базе данных
  1661.       description: |
  1662.         В данном запросе создаём Плейлист в базе данных.
  1663.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на дашборде или девдаше! для использования данного запроса необходимо ввести токен модератора.
  1664.       consumes:
  1665.        - multipart/form-data
  1666.       parameters:
  1667.         - in: formData
  1668.           name: type
  1669.           description: Тип нового Плейлиста в БД (тип 1 - пользовательский плейлист; тип 2 - альбом; тип 3 - сборник; тип 4 - системный плейлист; тип 5 - сингл)
  1670.           required: true
  1671.           type: string
  1672.         - in: formData
  1673.           name: released_at
  1674.           description: Дата релиза нового Плейлиста в БД
  1675.           required: true
  1676.           type: string
  1677.           default: "2017-03-07"
  1678.         - in: formData
  1679.           name: name
  1680.           description: Имя нового Плейлиста в БД
  1681.           required: true
  1682.           type: string
  1683.         - in: formData
  1684.           name: image
  1685.           description: Картинка нового Плейлиста в БД
  1686.           type: file
  1687.       responses:
  1688.         201:
  1689.           description: Возвращает информацию по созданному Артисту
  1690.           schema:
  1691.             type: object
  1692.             title: Детали артиста
  1693.             properties:
  1694.               data:
  1695.                 $ref: '#/definitions/Created-Artist-details'
  1696.    
  1697.   /playlists/{playlist_id}:
  1698.     get:
  1699.       security:
  1700.         - Bearer: []
  1701.       tags:
  1702.        - playlists
  1703.       summary: Показать информацию плейлиста.
  1704.       description: В этом запросе возвращается информация плейлиста, чей ID мы указываем.
  1705.       parameters:
  1706.         - in: path
  1707.           type: string
  1708.           name: playlist_id
  1709.           required: true
  1710.           default: "87877d0a-500c-5f1c-b70c-3dc219e13cec"
  1711.           description: ID плейлиста - как пример указан ID плейлиста "Назад в 2016"
  1712.       responses:
  1713.         200:
  1714.           description: "Лист с популярными синглами исполнителя"
  1715.           schema:
  1716.             type: object
  1717.             title: Детали альбомов
  1718.             properties:
  1719.               data:
  1720.                 $ref: '#/definitions/Playlist-details'
  1721.     delete:
  1722.       security:
  1723.         - Bearer: []
  1724.       tags:
  1725.        - playlists
  1726.       summary: Удалить плейлист
  1727.       description: |
  1728.        В этом запросе мы удаляем плейлист, чей ID мы указываем.
  1729.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1730.       parameters:
  1731.         - in: path
  1732.           type: string
  1733.           name: playlist_id
  1734.           required: true
  1735.           description: ID плейлиста - данный ID присутствует у каждого объекта контента
  1736.       responses:
  1737.         204:
  1738.           description: Если у плейлиста не было никакого контента, то он просто удаляется и возвращается пустое body. в ответе вернулось только слово "NOCONTENT"
  1739.     put:
  1740.       security:
  1741.         - Bearer: []
  1742.       tags:
  1743.        - playlists
  1744.       summary: Редактировать ротацию треков внутри плейлиста.
  1745.       description: В этом запросе мы редактируем ротацию треков плейлиста, чей ID мы указываем.
  1746.       parameters:
  1747.         - in: path
  1748.           type: string
  1749.           name: playlist_id
  1750.           required: true
  1751.           description: ID плейлиста в котором хотим произвести изменения.
  1752.         - in: body
  1753.           name: Model
  1754.           description: Изменённые данные ротации треков
  1755.           required: true
  1756.           schema:
  1757.             type: array
  1758.             items:
  1759.                $ref: '#/definitions/Playlist-rotation-model'
  1760.       responses:
  1761.         200:
  1762.           description: "Лист с информацией о плейлисте"
  1763.          
  1764. #     ====================== Не ЗНАЮ КАК ОФОРМИТЬ ДАННЫЙ ЗАПРОС ===================================        
  1765.                  
  1766.   /playlists/{playlist_id}/songs:
  1767.     get:
  1768.       security:
  1769.         - Bearer: []
  1770.       tags:
  1771.        - playlists
  1772.       summary: Показать список треков данного альбома
  1773.       description: Этот метода возвращает лист треков + инфорамация в каких еще альбомах этот трек встречается. ?expand=albums именно для этого служит.
  1774.       parameters:
  1775.         - in: path
  1776.           type: string
  1777.           name: playlist_id
  1778.           required: true
  1779.           default: "c81308af-0e28-2dfe-0ab6-bc6fc5833c4b"
  1780.           description: Это ID альбома или плейлиста. Как пример стоит альбома Шахзоды - Мухаббатим
  1781.         - in: query
  1782.           type: string
  1783.           name: expand
  1784.           default: albums
  1785.           description: albums = альбомы где встречается этот трек, artists = исполнители встречающиеся в этом треке
  1786.       responses:
  1787.         200:
  1788.           description: Лист с информацией о треке
  1789.           schema:
  1790.             type: object
  1791.             title: Детали трека
  1792.             properties:
  1793.               data:
  1794.                 $ref: '#/definitions/Track-details'
  1795.         404:
  1796.           description: Если плейлист не найден
  1797.     post:
  1798.       security:
  1799.         - Bearer: []
  1800.       tags:
  1801.        - playlists
  1802.       summary: Добавить треки в плейлист
  1803.       description: |
  1804.        В этом запросе мы добавляем треки в плейлист, чей ID мы указываем.
  1805.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1806.       parameters:
  1807.         - in: path
  1808.           type: string
  1809.           name: playlist_id
  1810.           required: true
  1811.           description: "ID плейлиста, к которому необходимо добавить другие треки"
  1812.       responses:
  1813.         200:
  1814.           description: "Треки добавились в плейлист"
  1815.          
  1816.   /playlists/{playlist_id}/songs/{song_id}:
  1817.     delete:
  1818.       security:
  1819.         - Bearer: []
  1820.       tags:
  1821.        - playlists
  1822.       summary: Удалить из плейлиста один трек
  1823.       description: |
  1824.         В этом запросе мы удаляем трек (song_id) из плейлиста (playlist_id)
  1825.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1826.       parameters:
  1827.         - in: path
  1828.           type: string
  1829.           name: playlist_id
  1830.           required: true
  1831.           description: ID плейлиста - данный ID присутствует у каждого объекта контента
  1832.         - in: path
  1833.           type: string
  1834.           name: song_id
  1835.           required: true
  1836.           description: ID песни - необходимо брать из дашборда/девдаша.
  1837.       responses:
  1838.         204:
  1839.           description: Трек удаляется и возвращается пустое body. в ответе вернулось только слово "NOCONTENT". В дашборде трек удалился из плейлиста.
  1840.    
  1841.   /playlists/{playlist_id}/copy/{type}:  
  1842.     get:
  1843.       security:
  1844.         - Bearer: []
  1845.       tags:
  1846.        - playlists
  1847.       summary: Создать копию плейлиста с указанием типа для этого плейлиста.
  1848.       description: |
  1849.         В этом запросе Создаём копию плейлиста с указанием типа для этого плейлиста.
  1850.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1851.       parameters:
  1852.         - in: path
  1853.           type: string
  1854.           name: playlist_id
  1855.           required: true
  1856.           default: "77c20564-9f3e-8134-cea4-28b63124250d"
  1857.           description: ID плейлиста - Men's health (devdash)
  1858.         - in: path
  1859.           type: integer
  1860.           name: type
  1861.           required: true
  1862.           description: "тип 1 - пользовательский плейлист; тип 2 - альбом; тип 3 - сборник; тип 4 - системный плейлист; тип 5 - сингл"
  1863.       responses:
  1864.         200:
  1865.           description: Возвращается информация о созданной копии плейлиста
  1866.           schema:
  1867.             type: object
  1868.             title: Детали созданной копии плейлиста
  1869.             properties:
  1870.               data:
  1871.                 $ref: '#/definitions/Playlist-copy-details'
  1872.    
  1873. #               ====================  UPDATES  ====================
  1874.  
  1875.   /updates/{type}/{version}:
  1876.     get:
  1877.       security:
  1878.         - Bearer: []
  1879.       tags:
  1880.        - updates
  1881.       summary: Проверить наличие обновлений
  1882.       description: |
  1883.        В этом запросе мы проверяем наличие обновлений для пользователей.
  1884.         "Детальное описание на: http://help.lamuz.uz/index.php?title=%D0%9E%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F"
  1885.       parameters:
  1886.         - in: path
  1887.           type: string
  1888.           name: type
  1889.           required: true
  1890.           description: Это тип операционной системы (Android 1 / iOS 2)
  1891.         - in: path
  1892.           type: string
  1893.           name: version
  1894.           default: "1.4"
  1895.           required: true
  1896.           description: Это текущая версия приложения
  1897.       responses:
  1898.         200:
  1899.           description: Если есть обновление для этой версии
  1900.           schema:
  1901.             type: object
  1902.             title: Детали обновления
  1903.             properties:
  1904.               data:
  1905.                 $ref: '#/definitions/Updates-details'
  1906.         304:
  1907.           description: Если текущая версия является последней (актуальной)
  1908.         404:
  1909.           description: Если запись наличия этой версии в БД обновлений нету
  1910.  
  1911. #               ====================  ANALITICS  ====================
  1912.  
  1913.   /analytics:
  1914.     get:
  1915.       security:
  1916.         - Bearer: []
  1917.       tags:
  1918.        - analytics
  1919.       summary: Отображение аналитики по прослушиваниям (iOS/Android или ВСЁ СРАЗУ)
  1920.       description: |
  1921.         Получение списка всех прослушиваний пользователей в базе данных.
  1922.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1923.       parameters:
  1924.         - in: query
  1925.           type: string
  1926.           name: "song_id"
  1927.           description: "включить в результат запроса прослушивание только этого трека"
  1928.         - in: query
  1929.           type: string
  1930.           name: "from"
  1931.           default: "2017-02-10"
  1932.           description: "включить в результат запроса дату, С которой ведём отчёт для статистики"
  1933.         - in: query
  1934.           type: string
  1935.           name: "platform"
  1936.           default: "android"
  1937.           description: "включить в результат запроса ОС пользователя (android/ios)"
  1938.         - in: query
  1939.           type: string
  1940.           name: "to"
  1941.           default: "2017-02-15"
  1942.           description: "включить в результат запроса дату, ДО которой ведём отчёт для статистики"
  1943.         - in: query
  1944.           type: integer
  1945.           name: "type"
  1946.           required: false
  1947.           default: 1
  1948.           description: "прослушан ли трек более чем на 50% (тип 1 - прослушан и тип 0 - не прослушан)"
  1949.       responses:
  1950.           200:
  1951.             description: отобразить статистику по прослушиваниям по введённому периоду времени и типу ОС клиента
  1952.     put:
  1953.       security:
  1954.         - Bearer: []
  1955.       tags:
  1956.        - analytics
  1957.       summary: Добавление записей в статистику
  1958.       description: Данный запрос отправляет эти данные клиента на сервер для того, чтобы статистика прослушиваний пополнялась
  1959.       parameters:
  1960.         - in: body
  1961.           name: Обновленные данные прослушиваний для статистики
  1962.           description: Элементы статистики прослушивания
  1963.           required: true
  1964.           schema:
  1965.             $ref: "#/definitions/Elements-of-the-listening-statistics"
  1966.       responses:
  1967.         200:
  1968.           description: Данные добавились
  1969.      
  1970.   /analytics/users:
  1971.     get:
  1972.       security:
  1973.         - Bearer: []
  1974.       tags:
  1975.        - analytics
  1976.       summary: Отображение активности пользователей (iOS/Android или ВСЁ СРАЗУ)
  1977.       description: |
  1978.         Получение списка всех прослушиваний пользователей в базе данных.
  1979.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  1980.         Для использования данного запроса необходимо ввести токен модератора или администратора.
  1981.         В данном запросе мы рассматриваем работу аналитики по отслеживанию активности пользователей.
  1982.       parameters:
  1983.         - in: query
  1984.           type: string
  1985.           name: "from"
  1986.           required: true
  1987.           default: "2017-01-03"
  1988.           description: "включить в результат запроса дату, С которой ведём отчёт для статистики"
  1989.         - in: query
  1990.           type: string
  1991.           name: "platform"
  1992.           default: "android"
  1993.           description: "включить в результат запроса ОС пользователя (Android/iOS)"
  1994.         - in: query
  1995.           type: string
  1996.           name: "to"
  1997.           required: true
  1998.           default: "2017-03-03"
  1999.           description: "включить в результат запроса дату, ДО которой ведём отчёт для статистики"
  2000.       responses:
  2001.           200:
  2002.             description: отобразить статистику по активности пользователей по введённому периоду времени и типу ОС клиента
  2003.      
  2004.   /analytics/registrations:
  2005.     get:
  2006.       security:
  2007.         - Bearer: []
  2008.       tags:
  2009.        - analytics
  2010.       summary: Отображение количества регистраций пользователей (iOS/Android или ВСЁ СРАЗУ)
  2011.       description: |
  2012.         Получение списка всех регистраций пользователей в базе данных.
  2013.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  2014.         Для использования данного запроса необходимо ввести токен модератора или администратора.
  2015.         В данном запросе мы рассматриваем работу аналитики по отслеживанию регистраций пользователей.
  2016.       parameters:
  2017.         - in: query
  2018.           type: string
  2019.           name: "from"
  2020.           required: true
  2021.           default: "2017-01-03"
  2022.           description: "включить в результат запроса дату, С которой ведём отчёт для статистики"
  2023.         - in: query
  2024.           type: string
  2025.           name: "platform"
  2026.           default: "android"
  2027.           description: "включить в результат запроса ОС пользователя (Android/iOS)"
  2028.         - in: query
  2029.           type: string
  2030.           name: "to"
  2031.           required: true
  2032.           default: "2017-03-03"
  2033.           description: "включить в результат запроса дату, ДО которой ведём отчёт для статистики"
  2034.       responses:
  2035.           200:
  2036.             description: отобразить статистику по регистрациям пользователей по введённому периоду времени и типу ОС клиента
  2037.              
  2038.   /analytics/uploads:
  2039.     get:
  2040.       security:
  2041.         - Bearer: []
  2042.       tags:
  2043.        - analytics
  2044.       summary: Отображение количества загрузок треков в БД
  2045.       description: |
  2046.         Получение списка всех загруженных треков в базу данных за определённую дату или промежуток времени.
  2047.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  2048.         Для использования данного запроса необходимо ввести токен модератора или администратора.
  2049.         В данном запросе мы рассматриваем работу аналитики по отслеживанию загруженных треков
  2050.       parameters:
  2051.         - in: query
  2052.           type: string
  2053.           name: "from"
  2054.           required: true
  2055.           default: "2017-01-03"
  2056.           description: "включить в результат запроса дату, С которой ведём отчёт для статистики"
  2057.         - in: query
  2058.           type: string
  2059.           name: "to"
  2060.           required: true
  2061.           default: "2017-03-03"
  2062.           description: "включить в результат запроса дату, ДО которой ведём отчёт для статистики"
  2063.       responses:
  2064.           200:
  2065.             description: отобразить статистику по загрузкам треков в базу данных по введённому периоду времени
  2066.  
  2067. #               ====================  NOTIFICATIONS  ====================
  2068.            
  2069.   /notifications:
  2070.     get:
  2071.       security:
  2072.         - Bearer: []
  2073.       tags:
  2074.        - notification
  2075.       summary: Вернуть список уведомлений (пуши)
  2076.       description: |
  2077.         Вернуть список пуш уведомлений
  2078.         > Внимание - отправляемый токен должен принадлежать пользователю с правами модератора. гость не может редактировать!
  2079.       parameters:
  2080.         - in: query
  2081.           type: integer
  2082.           format: int32
  2083.           name: limit
  2084.           default: 50
  2085.           description: Лимит возвращаемого результата
  2086.         - in: query
  2087.           type: integer
  2088.           format: int32
  2089.           name: page
  2090.           default: 1
  2091.           description: Номер страницы (пагинация)
  2092.       responses:
  2093.         200:
  2094.           description: Возвращается массив со списком уведомлений на пуши
  2095.           schema:
  2096.             type: object
  2097.             title: Notification model
  2098.             properties:
  2099.               data:
  2100.                 $ref: '#/definitions/Notification-details'          
  2101.                
  2102. #               ====================  CODES  ====================
  2103.  
  2104.   /codes/{code_id}:
  2105.     get:
  2106.       security:
  2107.         - Bearer: []
  2108.       tags:
  2109.        - code
  2110.       summary: Запрос в приложение, через уникальный код, отправляемый через share
  2111.       description: В этом запросе мы получаем объект, основанный на коде от модели (используется для акций URL). коды применимы к Треку, Плейлисту (Любой плейлист вне зависимости от типа), Артисту
  2112.       parameters:
  2113.         - in: path
  2114.           type: string
  2115.           name: code_id
  2116.           required: true
  2117.           default: "OoQmu6n"
  2118.           description: уникальный код share для объекта - как пример указан код на трек из devdash.lamuz.uz "Me, Myself & I - Marc Stout & Scott Svejda Remix"
  2119.       responses:
  2120.         200:
  2121.           description: Возвращается информация о композиции
  2122.           schema:
  2123.             type: object
  2124.             title: Track model
  2125.             properties:
  2126.               data:
  2127.                 $ref: '#/definitions/Track-details'
  2128.                
  2129. #               ====================  ADVERTISING  ====================
  2130.  
  2131.   /ads/campaign:
  2132.     get:
  2133.       security:
  2134.         - Bearer: []
  2135.       tags:
  2136.        - ADS
  2137.       summary: Вернуть список с рекламными объявлениями
  2138.       description: |
  2139.         Получение списка всей рекламы в базе данных. Данный запрос работает только с дашбордом/девдашем.
  2140.         > Внимание! для использования данного запроса необходимо быть Модератором или Администратором на http://dashboard.lamuz.uz или http://devdash.lamuz.uz.
  2141.         Для использования данного запроса необходимо ввести токен модератора или администратора.
  2142.       responses:
  2143.           200:
  2144.             description: Возвращается список рекламных объявлений
  2145.             schema:
  2146.               type: object
  2147.               title: ADS model
  2148.               properties:
  2149.                 data:
  2150.                   $ref: '#/definitions/ADS-details'
  2151.                  
  2152. #               ====================  SYNC  ====================                  
  2153.  
  2154.   /users/sync/likes/1:
  2155.     post:
  2156.       security:
  2157.         - Bearer: []
  2158.       tags:
  2159.        - user
  2160.         - sync
  2161.       summary: Синхронизация и добавление Трека
  2162.       description: |
  2163.         В данном запросе мы производим синхронизацию для добавление Треку лайк.
  2164.         > Внимание - отправляемый токен должен принадлежать пользователю с активной сессией.
  2165.       consumes:
  2166.        - application/json
  2167.       parameters:
  2168.         - in: body
  2169.           name: Синхронизация лайков для Треков
  2170.           description: В данной модели мы отправляем (actionTime - время добавления треку лайка, entityId - id для трека, которому ставим лайк, status - 1 лайк / 0 - дизлайк)
  2171.           required: true
  2172.           schema:
  2173.             $ref: "#/definitions/Sync-Track-Model"
  2174.       responses:
  2175.         200:
  2176.           description: Возвращается информация для одного трека из 3-х и модель трека со статусом лайка и последней датой синхронизации
  2177.           schema:
  2178.             $ref: "#/definitions/Sync-like-Track-details"
  2179. #     ====================== ВОЗВРАЩАЕТСЯ ТОЛЬКО ОДИН ТРЕК ИЗ 3-Х ===================================
  2180.   /users/sync/likes/3:
  2181.     post:
  2182.       security:
  2183.         - Bearer: []
  2184.       tags:
  2185.        - user
  2186.         - sync
  2187.       summary: Синхронизация и добавление Артиста
  2188.       description: |
  2189.         В данном запросе мы производим синхронизацию для добавление Артисту лайк.
  2190.         > Внимание - отправляемый токен должен принадлежать пользователю с активной сессией.
  2191.       consumes:
  2192.        - application/json
  2193.       parameters:
  2194.         - in: body
  2195.           name: Синхронизация лайков для Артистов
  2196.           description: В данной модели мы отправляем (actionTime - время добавления артисту лайка, entityId - id для артиста, которому ставим лайк, status - 1 лайк / 0 - дизлайк)
  2197.           required: true
  2198.           schema:
  2199.             $ref: "#/definitions/Sync-Artist-Model"
  2200.       responses:
  2201.         200:
  2202.           description: Возвращает модель артиста со статусом лайка и последней датой синхронизации
  2203.           schema:
  2204.             $ref: "#/definitions/Sync-like-Artist-details"
  2205.          
  2206.   /users/sync/likes/4:
  2207.     post:
  2208.       security:
  2209.         - Bearer: []
  2210.       tags:
  2211.        - user
  2212.         - sync
  2213.       summary: Синхронизация и добавление лайка Плейлисту
  2214.       description: |
  2215.         В данном запросе мы производим синхронизацию для добавление Плейлисту лайк.
  2216.         > Внимание - отправляемый токен должен принадлежать пользователю с активной сессией.
  2217.       consumes:
  2218.        - application/json
  2219.       parameters:
  2220.         - in: body
  2221.           name: Синхронизация лайков для Плейлиста
  2222.           description: В данной модели мы отправляем (actionTime - время добавления плейлисту лайка, entityId - id для плейлиста, которому ставим лайк, status - 1 лайк / 0 - дизлайк)
  2223.           required: true
  2224.           schema:
  2225.             $ref: "#/definitions/Sync-Playlist-Model"
  2226.       responses:
  2227.         200:
  2228.           description: Возвращает модель артиста со статусом лайка и последней датой синхронизации
  2229.           schema:
  2230.             $ref: "#/definitions/Sync-like-Playlist-details"
  2231.  
  2232.      
  2233. ################################################################################
  2234. #                                 definitions                                  #
  2235. ################################################################################
  2236. definitions:
  2237.  
  2238.   Roles:
  2239.     type: object
  2240.     properties:
  2241.       type:
  2242.         type: integer
  2243.         format: int32
  2244.         description: Не знаю что это значит
  2245.       name:
  2246.         type: string
  2247.         description: Название роли
  2248.       description:
  2249.         type: string
  2250.         description: описание данной роли
  2251.       ruleName:
  2252.         type: string
  2253.         description: Не знаю что это значит
  2254.       data:
  2255.         type: string
  2256.         description: "Не знаю что это значит (null)"
  2257.       createdAt:
  2258.         type: integer
  2259.         format: int32
  2260.         description: Дата создания роли
  2261.       updatedAt:
  2262.         type: integer
  2263.         format: int32
  2264.         description: Дата обновления роли
  2265.      
  2266.   User:
  2267.     type: object
  2268.     properties:
  2269.       token:
  2270.         type: string
  2271.         description: токен пользователя в виде hash, валидный на 7 дней [php-backend/config/api/params.php]
  2272.       user:
  2273.         type: object
  2274.         properties:
  2275.           id:
  2276.             type: string
  2277.             description: "UUID пользователя"
  2278.           status:
  2279.             type: integer
  2280.             format: int32
  2281.             description: 0=заблокирован, 1=активный, 2=удален, 3=email не подтвержден
  2282.           login:
  2283.             type: string
  2284.           fb_id:
  2285.             type: string
  2286.           vk_id:
  2287.             type: string
  2288.           ok_id:
  2289.             type: string
  2290.           gp_id:
  2291.             type: string
  2292.           created_at:
  2293.             type: string
  2294.             description: Дата создания пользователя
  2295.           roles:
  2296.             type: array
  2297.             items:
  2298.               $ref: '#/definitions/Roles'
  2299.           cover:
  2300.             type: string
  2301.             description: URL на картинку пользователя
  2302.           cover_id:
  2303.             type: string
  2304.             description: ХЗ что это
  2305.           account_number:
  2306.             type: integer
  2307.             format: int32
  2308.             description: номер из биллинга, например для оплаты через пайнет
  2309.           code:
  2310.             type: string
  2311.             description: уникальный реферальный код пользователя в системе. Это линк на его профиль
  2312.           balance:
  2313.             type: integer
  2314.             format: int64
  2315.             description: баланс денег на счету у пользователя, указывается в сумах (тийн - не уверен)
  2316.           isPremium:
  2317.             type: boolean
  2318.             description: Показатель состояния пользователя в системе премиум или нет (true/false)  
  2319.           profile:
  2320.             type: object
  2321.             properties:
  2322.               first_name:
  2323.                 type: string
  2324.               last_name:
  2325.                 type: string
  2326.               email:
  2327.                 type: string
  2328.               phone:
  2329.                 type: string
  2330.               gender:
  2331.                 type: integer
  2332.                 format: int32
  2333.                 description: 1=мужчина, 0-женщина
  2334.               birthday:
  2335.                 type: integer
  2336.                 format: int32
  2337.                 description: пример даты рождения 1998 или 2000
  2338.            
  2339.   Publisher:
  2340.     type: object
  2341.     properties:
  2342.       id:
  2343.         type: string
  2344.         description: "ID Издателя"
  2345.       status:
  2346.         type: integer
  2347.         format: int32
  2348.         description: 0=заблокирован, 1=активный, 2=удален, 3=email не подтвержден
  2349.       login:
  2350.         type: string
  2351.       fb_id:
  2352.         type: string
  2353.       vk_id:
  2354.         type: string
  2355.       ok_id:
  2356.         type: string
  2357.       gp_id:
  2358.         type: string
  2359.       created_at:
  2360.         type: string
  2361.         description: Дата создания Издателя
  2362.       roles:
  2363.         type: array
  2364.         items:
  2365.           $ref: '#/definitions/Roles'
  2366.       cover:
  2367.         type: string
  2368.         description: URL на картинку Издателя
  2369.       cover_id:
  2370.         type: string
  2371.         description: ХЗ что это
  2372.       code:
  2373.         type: string
  2374.         description: уникальный реферальный код Издателя в системе. Это линк на его профиль
  2375.       account_number:
  2376.         type: integer
  2377.         format: int32
  2378.         description: номер из биллинга, например для оплаты через пайнет
  2379.       balance:
  2380.         type: integer
  2381.         format: int64
  2382.         description: баланс денег на счету у Издателя, указывается в сумах (тийн - не уверен)
  2383.       isPremium:
  2384.         type: boolean
  2385.         description: Показатель состояния Издателя в системе премиум или нет (true/false)    
  2386.  
  2387.   User-credentials-login:
  2388.     type: object
  2389.     required:
  2390.      - login
  2391.       - password
  2392.     properties:
  2393.       login:
  2394.         type: string
  2395.         default: davronuz
  2396.       password:
  2397.         type: string
  2398.         default: davronuz
  2399.       repassword:
  2400.         type: string
  2401.      
  2402.   User-credentials-logout:
  2403.     type: object
  2404.     required:
  2405.      - login
  2406.       - password
  2407.     properties:
  2408.       login:
  2409.         type: string
  2410.         default: davronuz
  2411.       password:
  2412.         type: string
  2413.         default: davronuz
  2414.  
  2415.   User-credentials-oAuth:
  2416.     type: object
  2417.     required:
  2418.      - network
  2419.       - id
  2420.     properties:
  2421.       network:
  2422.         type: string
  2423.         description: facebook, vk, odnoklassniki, google
  2424.         default: facebook
  2425.       id:
  2426.         type: string
  2427.         description: ID который возвращает соц сеть
  2428.         default: "973438249400230"
  2429.       birthday:
  2430.         type: integer
  2431.         format: int32
  2432.         description: пример даты рождения 1998 или 2000
  2433.         default: 1991
  2434.       first_name:
  2435.         type: string
  2436.         default: Yaroslav
  2437.       last_name:
  2438.         type: string
  2439.         default: Samardak
  2440.       gender:
  2441.         type: integer
  2442.         format: int32
  2443.         description: 1=мужчина, 0-женщина
  2444.         default: 1      
  2445.       email:
  2446.         type: string
  2447.         default: samardak.yaroslav@gmail.com
  2448.       image:
  2449.         type: string
  2450.         description: URL на фото профиля в соц сети
  2451.         default: "https://graph.facebook.com/973438249400230/picture?height\u003d500\u0026width\u003d500\u0026migration_overrides\u003d%7Boctober_2012%3Atrue%7D"
  2452.  
  2453.   User-credentials-profile:
  2454.     type: object
  2455.     properties:
  2456.       first_name:
  2457.         type: string
  2458.         description: обязательно имя
  2459.         default: Даврон
  2460.       last_name:
  2461.         type: string
  2462.         description: обязательно фамилия
  2463.         default: Узакбаев
  2464.       email:
  2465.         type: string
  2466.         description: обязательно email
  2467.         default: davron_1995@bk.ru
  2468.       birthday:
  2469.         type: integer
  2470.         format: int32
  2471.         description: пример даты рождения 1998 или 2000
  2472.         default: 1995
  2473.       gender:
  2474.         type: integer
  2475.         format: int32
  2476.         description: 1=мужчина, 0-женщина
  2477.         default: 1
  2478.  
  2479.   User-credentials-signup:
  2480.     type: object
  2481.     required:
  2482.      - login
  2483.       - email
  2484.       - password
  2485.       - repassword
  2486.       - birthday
  2487.       - gender
  2488.     properties:
  2489.       login:
  2490.         type: string
  2491.         description: обязательно login
  2492.         default: swagger-test
  2493.       email:
  2494.         type: string
  2495.         description: обязательно email
  2496.         default: swagger-test@mailinator.com
  2497.       password:
  2498.         type: string
  2499.         default: swagger
  2500.       repassword:
  2501.         type: string
  2502.         default: swagger
  2503.       birthday:
  2504.         type: integer
  2505.         format: int32
  2506.         description: пример даты рождения 1998 или 2000
  2507.         default: 1990
  2508.       gender:
  2509.         type: integer
  2510.         format: int32
  2511.         description: 1=мужчина, 0-женщина
  2512.         default: 1
  2513.        
  2514.   User-resend-email:
  2515.     type: object
  2516.     required:
  2517.      - type
  2518.       - userId
  2519.     properties:
  2520.       type:
  2521.         type: string
  2522.         description: определяет какой шаблон письма отправить (на данный момент был только signup)
  2523.         default: signup
  2524.       userId:
  2525.         type: string
  2526.         default: "5a56ecf2-bbce-66c5-d72e-9023a8a11b49"
  2527.         description: это ID логина testlamuz на продашн сервере. Почта testlamuz@mailinator.com
  2528.  
  2529.   User-password-recovery:
  2530.     type: object
  2531.     required:
  2532.      - password
  2533.       - repassword
  2534.     properties:
  2535.       password:
  2536.         type: string
  2537.       repassword:
  2538.         type: string
  2539.  
  2540.   User-recovery-type:
  2541.     type: object
  2542.     properties:
  2543.       recovery_mode:
  2544.         type: integer
  2545.         format: int32
  2546.         description: Всегда возвращает 0 или null не знаю что это значит
  2547.       recovery_data:
  2548.         type: string
  2549.         description: Тут может быть номер телефона или секретный вопрос ответ
  2550.       email:
  2551.         type: integer
  2552.         format: int32
  2553.         description: Всегда возвращает 1 не знаю что это значит
  2554.        
  2555. #  Check-user-login/email:
  2556. #    type: object
  2557. #    required:
  2558. #      - login
  2559. #    properties:
  2560. #      login:
  2561. #        type: string
  2562. #      email:
  2563. #        type: string
  2564.  
  2565.   Updates-details:
  2566.     type: object
  2567.     properties:
  2568.       id:
  2569.         type: string
  2570.         description: хз что это (ID какой-то)
  2571.       version:
  2572.         type: string
  2573.         description: Версия приложения
  2574.       core_version:
  2575.         type: string
  2576.         description: Версия ядра
  2577.       platform:
  2578.         type: integer
  2579.         format: int32
  2580.         description: "Какую платформу используем Android 1 / iOS 2"
  2581.       type:
  2582.         type: integer
  2583.         format: int32
  2584.         description: "Обязательное ли обновление или нет. 1- да / 0 - нет"
  2585.       days:
  2586.         type: integer
  2587.         format: int32
  2588.         description: "раз в сколько дней напоминать пользователю о обновлении"
  2589.       cover:
  2590.         type: string
  2591.         description: линк на изображение в окне обновления
  2592.         default: "http://devdl.lamuz.uz/update/default.jpg?ts=1"
  2593.       status:
  2594.         type: integer
  2595.         format: int32
  2596.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2597.      
  2598.   Track-details:
  2599.     type: object
  2600.     properties:
  2601.       id:
  2602.         type: string
  2603.         description: уникальный номер трека в системе
  2604.       title:
  2605.         type: string
  2606.         description: название трека
  2607.       duration:
  2608.         type: integer
  2609.         format: int32
  2610.         description: длина произведения в секундах
  2611.       listen:
  2612.         type: integer
  2613.         format: int32
  2614.         description: количество прослушиваний
  2615.       status:
  2616.         type: integer
  2617.         format: int32
  2618.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2619.       language:
  2620.         type: string
  2621.         description: язык на котором спета песня
  2622.       year:
  2623.         type: integer
  2624.         format: int32
  2625.         description: год выпуска трека, например 2000 (четыре цифры)
  2626.       url:
  2627.         type: string
  2628.         description: сайт откуда взят трек
  2629.       composer:
  2630.         type: string
  2631.         description: кто является композитором, если это классическая музыка.
  2632.       publisher_id:
  2633.         type: string
  2634.         description: уникальный номер правообладаетля в системе
  2635.       country:
  2636.         type: string
  2637.         description: страна где был выпущен этот трек
  2638.       censorship:
  2639.         type: boolean
  2640.         description: если есть мат то пишем true
  2641.       original_artist:
  2642.         type: string
  2643.         description: оригинальный исполнитель трека, если трек является кавером
  2644.       created_at:
  2645.         type: string
  2646.         description: дата загрузки трека в систему
  2647.       updated_at:
  2648.         type: string
  2649.         description: дата, когда были обновлены данные в треке
  2650.       representation:
  2651.         type: string
  2652.         description: линк для ядра(плеер) в виде JSON где есть инфо о видах репрезентации (качеств трека)
  2653.       cover:
  2654.         type: string
  2655.         description: линк на картину трека\альбома. Иногда называется кавер
  2656.       cover_id:
  2657.         type: string
  2658.         description: Айдишка трека, точно незнаю что это
  2659.       likes:
  2660.         type: integer
  2661.         format: int32
  2662.         description: количество нажатых лайков
  2663.       artists:
  2664.         type: array
  2665.         items:
  2666.           $ref: '#/definitions/Artist-details'
  2667.       mainArtist:
  2668.         type: array
  2669.         items:
  2670.           $ref: '#/definitions/mainArtist-details'
  2671.       code:
  2672.         type: string
  2673.         description: код для того чтобы поделиться треком с другом
  2674.       available:
  2675.         type: boolean
  2676.         description: указывает доступен ли трек для проигрывания для данного пользователя ture\false
  2677.       publish_date:
  2678.         type: integer
  2679.         format: int32
  2680.         description: дата с какого числа должен трек быть доступен в системе. Если это премьера правообладатель может захотеть чтобы дата была в будущем
  2681.       genre:
  2682.         type: array
  2683.         items:
  2684.           $ref: '#/definitions/Genre-details'
  2685.       albums:
  2686.         type: array
  2687.         items:
  2688.           $ref: '#/definitions/Album-details'
  2689.       regions:
  2690.         type: array
  2691.         items:
  2692.           $ref: '#/definitions/Regions-details'
  2693.        
  2694.   Artist-details:
  2695.     type: object
  2696.     properties:
  2697.       id:
  2698.         type: string
  2699.         description: уникальный id исполнителя
  2700.         default: "c46993b8-8bdb-46a8-afa4-f274b1805cd0"
  2701.       name:
  2702.         type: string
  2703.         description: имя исполнителя
  2704.         default: Dado
  2705.       status:
  2706.         type: integer
  2707.         format: int32
  2708.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2709.       playlist_count:
  2710.         type: integer
  2711.         format: int32
  2712.         description: количество плейлистов у данного исполнителя
  2713.       songs_count:
  2714.         type: integer
  2715.         format: int32
  2716.         description: количество песен у данного исполнителя
  2717.       biography:
  2718.         type: string
  2719.         description: биография данного исполнителя
  2720.       cover:
  2721.         type: string
  2722.         description: линк на кавер исполнителя
  2723.       cover_id:
  2724.         type: string
  2725.         description: уникальтый id исполнителя (хз что это)
  2726.         default: "903f53bc-84ea-4097-9e68-bd8186166d9d"
  2727.       likes:
  2728.         type: integer
  2729.         format: int32
  2730.         description: количество пользователей, отметивших лайком исполнителя
  2731.       created_at:
  2732.         type: integer
  2733.         format: int32
  2734.         description: дата создания исполнителя
  2735.       updated_at:
  2736.         type: string
  2737.         format: date-time
  2738.         description: дата обновления записей об исполнителе
  2739.       available:
  2740.         type: string
  2741.         description: хз что это значит
  2742.       code:
  2743.         type: string
  2744.         description: шорт код для share
  2745.         default: "ap5BhBWX"
  2746.        
  2747.   mainArtist-details:
  2748.     type: object
  2749.     properties:
  2750.       id:
  2751.         type: string
  2752.         description: уникальный id исполнителя
  2753.         default: "c46993b8-8bdb-46a8-afa4-f274b1805cd0"
  2754.       name:
  2755.         type: string
  2756.         description: имя исполнителя
  2757.         default: Dado
  2758.       status:
  2759.         type: integer
  2760.         format: int32
  2761.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2762.       playlist_count:
  2763.         type: integer
  2764.         format: int32
  2765.         description: количество плейлистов у данного исполнителя
  2766.       songs_count:
  2767.         type: integer
  2768.         format: int32
  2769.         description: количество песен у данного исполнителя
  2770.       biography:
  2771.         type: string
  2772.         description: биография данного исполнителя
  2773.       cover:
  2774.         type: string
  2775.         description: линк на кавер исполнителя
  2776.       cover_id:
  2777.         type: string
  2778.         description: уникальтый id исполнителя (хз что это)
  2779.         default: "903f53bc-84ea-4097-9e68-bd8186166d9d"
  2780.       likes:
  2781.         type: integer
  2782.         format: int32
  2783.         description: количество пользователей, отметивших лайком исполнителя
  2784.       created_at:
  2785.         type: integer
  2786.         format: int32
  2787.         description: дата создания исполнителя
  2788.       updated_at:
  2789.         type: string
  2790.         format: date-time
  2791.         description: дата обновления записей об исполнителе
  2792.       available:
  2793.         type: string
  2794.         description: хз что это значит
  2795.       code:
  2796.         type: string
  2797.         description: шорт код для share
  2798.         default: "ap5BhBWX"
  2799.  
  2800.   Album-details:
  2801.     type: object
  2802.     properties:
  2803.       id:
  2804.         type: string
  2805.         description: не нашёл в дашборде этот id
  2806.         default: "2476c1ec-2bc1-48c6-9538-4f47faf89ffa"
  2807.       name:
  2808.         type: string
  2809.         description: название Альбома
  2810.         default: "Безупречная Любовь"
  2811.       type:
  2812.         type: integer
  2813.         format: int32
  2814.         description: код, для данного контента (2 - Альбом)
  2815.       status:
  2816.         type: integer
  2817.         format: int32
  2818.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2819.       songs_count:
  2820.         type: integer
  2821.         format: int32
  2822.         description: количество треков у данного альбома
  2823.         default: 11
  2824.       description:
  2825.         type: string
  2826.         description: возможно тут должно быть описание альбома
  2827.         default: "null"
  2828.       duration:
  2829.         type: integer
  2830.         format: int32
  2831.         description: продолжительность данного альбома
  2832.       user_id:
  2833.         type: string
  2834.         default: "49742231-1926-46a2-aec2-06224993b62e"
  2835.         description: уникальный ID модератора, который загрузил этот альбом (в данном случае ID Владимира Филатова)
  2836.       released_at:
  2837.         type: integer
  2838.         format: int32
  2839.         description: дата релиза данного альбома
  2840.       created_at:
  2841.         type: integer
  2842.         format: int32
  2843.         description: дата создания данного альбома
  2844.       visible:
  2845.         type: integer
  2846.         format: int32
  2847.         description: 1 - отображать, 0 - не отображать
  2848.       likes:
  2849.         type: integer
  2850.         format: int32
  2851.         description: количество лайков у альбома
  2852.       cover:
  2853.         type: string
  2854.         default: "http://dl.lamuz.uz/album/image/68d50b52-e3c1-4d0e-8e46-14fcc0402a78.jpg?ts=2091e8205ea9023d52d260b1a18b6901"
  2855.         description: линк на кавер Альбома
  2856.       cover_id:
  2857.         type: string
  2858.         default: "68d50b52-e3c1-4d0e-8e46-14fcc0402a78"
  2859.         description: уникальный ID кавера у альбома
  2860.       code:
  2861.         type: string
  2862.         description: шорт код для share
  2863.         default: "bexxhXQe"
  2864.        
  2865.   Playlist-details:
  2866.     type: object
  2867.     properties:
  2868.       id:
  2869.         type: string
  2870.         description: уникальный id плейлиста
  2871.         default: "f95074c2-b0ef-e1a3-97ee-eb1f50de6e32"
  2872.       name:
  2873.         type: string
  2874.         description: название Плейлиста
  2875.         default: "Танцуй как Ребенок"
  2876.       type:
  2877.         type: integer
  2878.         format: int32
  2879.         description: код, для данного контента (тип 1 - пользовательский плейлист; тип 2 - альбом; тип 3 - сборник; тип 4 - системный плейлист; тип 5 - сингл)
  2880.       status:
  2881.         type: integer
  2882.         format: int32
  2883.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2884.       songs_count:
  2885.         type: integer
  2886.         format: int32
  2887.         description: количество треков у данного плейлиста
  2888.       description:
  2889.         type: string
  2890.         description: ХЗ (возможно тут должно быть описание плейлиста)
  2891.       duration:
  2892.         type: integer
  2893.         format: int32
  2894.         description: Общая длительность данного плейлиста
  2895.       user_id:
  2896.         type: string
  2897.         default: "68066b8c-8282-4500-bad6-0c708f06ca82"
  2898.         description: уникальный ID пользователя, который создал данный объект
  2899.       released_at:
  2900.         type: integer
  2901.         format: int32
  2902.         description: дата релиза данного плейлиста
  2903.       created_at:
  2904.         type: integer
  2905.         format: int32
  2906.         description: дата создания данного плейлиста
  2907.       visible:
  2908.         type: integer
  2909.         format: int32
  2910.         description: 1 - отображать, 0 - не отображать
  2911.       likes:
  2912.         type: integer
  2913.         format: int32
  2914.         description: количество лайков у плейлиста
  2915.       cover:
  2916.         type: string
  2917.         default: "http://dl.lamuz.uz/playlist/image/c86214d1-32f4-958e-eee5-4db543da90c1.png?ts=2d8842a4ea842955cd5d969d3bf76c27"
  2918.         description: линк на кавер Плейлиста
  2919.       cover_id:
  2920.         type: string
  2921.         default: "c86214d1-32f4-958e-eee5-4db543da90c1"
  2922.         description: уникальный ID кавера у плейлиста
  2923.       code:
  2924.         type: string
  2925.         description: шорт код для share
  2926.         default: "vKK5I6Yr"
  2927.        
  2928.   Collection-details:
  2929.     type: object
  2930.     properties:
  2931.       id:
  2932.         type: string
  2933.         description: уникальный id Сборника
  2934.         default: "be05e409-cc4e-8135-1e7c-03a5ac99c9df"
  2935.       name:
  2936.         type: string
  2937.         description: название Сборника
  2938.         default: "Музыка для Путешествий в Машине"
  2939.       type:
  2940.         type: integer
  2941.         format: int32
  2942.         description: код, для данного контента (3 - Сборник)
  2943.       status:
  2944.         type: integer
  2945.         format: int32
  2946.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  2947.       songs_count:
  2948.         type: integer
  2949.         format: int32
  2950.         description: количество треков у данного Сборника
  2951.       description:
  2952.         type: string
  2953.         description: ХЗ (возможно тут должно быть описание Сборника)
  2954.       duration:
  2955.         type: integer
  2956.         format: int32
  2957.         description: продолжительность данного Сборника
  2958.       user_id:
  2959.         type: string
  2960.         default: "68066b8c-8282-4500-bad6-0c708f06ca82"
  2961.         description: уникальный ID пользователя
  2962.       released_at:
  2963.         type: integer
  2964.         format: int32
  2965.         description: дата релиза данного Сборника
  2966.       created_at:
  2967.         type: integer
  2968.         format: int32
  2969.         description: дата создания данного Сборника
  2970.       visible:
  2971.         type: integer
  2972.         format: int32
  2973.         description: 1 - отображать, 0 - не отображать
  2974.       likes:
  2975.         type: integer
  2976.         format: int32
  2977.         description: количество лайков у Сборника
  2978.       cover:
  2979.         type: string
  2980.         default: "http://dl.lamuz.uz/collection/image/490b9228-446e-d9aa-3891-608133f9c98d.png?ts=902bb829fa6147d90429baabc6ba7ee2"
  2981.         description: линк на кавер Сборника
  2982.       cover_id:
  2983.         type: string
  2984.         default: "490b9228-446e-d9aa-3891-608133f9c98d"
  2985.         description: уникальный ID кавера у Сборника
  2986.       code:
  2987.         type: string
  2988.         description: шорт код для share
  2989.         default: ""
  2990.       category:
  2991.         type: string
  2992.         description: к какой категории относится Сборник. но обычно возвращается поле "null"
  2993.       position:
  2994.         type: string
  2995.         description: позиция Сборника, но обычно возвращается "null"
  2996.        
  2997.   Category-details:
  2998.     type: object
  2999.     properties:
  3000.       id:
  3001.         type: string
  3002.         description: уникальный ID категории
  3003.         default: "3d10fe57-398a-7457-1a29-5c64e8d9f77f"
  3004.       title:
  3005.         type: string
  3006.         description: название Категории
  3007.         default: "Новогодняя"
  3008.       position:
  3009.         type: integer
  3010.         format: int32
  3011.         default: 1
  3012.         description: номер позиции Категории (всего 25)
  3013.       description:
  3014.         type: string
  3015.         default: "null"
  3016.         description: это описание категории (null - это пустое описание, т.е. его нет)
  3017.       cover:
  3018.         type: string
  3019.         default: "http://dl.lamuz.uz/category/image/90310340-298a-2beb-22cc-a412bdf1df3b.jpg?ts=72ae6f0b9adbf7101ba367150e9b3a89"
  3020.         description: линк на кавер Категории
  3021.       cover_id:
  3022.         type: string
  3023.         default: "90310340-298a-2beb-22cc-a412bdf1df3b"
  3024.         description: уникальный ID кавера Категории
  3025.       icon:
  3026.         type: string
  3027.         default: "http://dl.lamuz.uz/category/image/8d917a7a-3dac-588a-a2e9-c487f0cce7c4.png?ts=72ae6f0b9adbf7101ba367150e9b3a89"
  3028.         description: Иконка с описанием данной категории. Например белая иконка ёлочных шаров с надписью "Новогодняя".
  3029.       type:
  3030.         type: integer
  3031.         format: int32
  3032.         default: 2
  3033.         description: хз что это
  3034.       created_at:
  3035.         type: integer
  3036.         format: int32
  3037.         default: 1481014056
  3038.         description: дата создания данной категории
  3039.       updated_at:
  3040.         type: integer
  3041.         format: int32
  3042.         default: 1483522764
  3043.         description: дата обновления данной категории
  3044.        
  3045.   Notification-details:
  3046.     type: object
  3047.     properties:
  3048.       id:
  3049.         type: string
  3050.         description: уникальный ID уведомления
  3051.       type:
  3052.         type: integer
  3053.         format: int32
  3054.         description: тип уведомления (всего есть 7 типов уведомлений. каждый тип определяет какое уведомление отправляется пользователю и что за содержимое в этом самом уведомлении)
  3055.       platform:
  3056.         type: integer
  3057.         format: int32
  3058.         description: Платформа, на которую отправляется уведомление (1 - Android, 2 - iOS)
  3059.       title:
  3060.         type: string
  3061.         description: это описание уведомления (Заголовок)
  3062.       body:
  3063.         type: string
  3064.         default: "null"
  3065.         description: тело сообщения, в devdash отображается при отправке через Android
  3066.       entity_id:
  3067.         type: string
  3068.         description: нужен при передаче типа уведомлений альбом или трек, где передается идентификатор сущности
  3069.       description:
  3070.         type: string
  3071.         default: "null"
  3072.         description: Возможно это описание уведомления
  3073.       url:
  3074.         type: string
  3075.         default: "null"
  3076.         description: URL на уведомление, но оно пустое
  3077.       collapse_key:
  3078.         type: string
  3079.         default: "null"
  3080.         description: Не знаю, что это
  3081.       created_at:
  3082.         type: integer
  3083.         format: int32
  3084.         description: дата создания данного уведомления
  3085.      
  3086.   Genre-details:
  3087.     type: object
  3088.     properties:
  3089.       id:
  3090.         type: string
  3091.         description: уникальный ID жанра
  3092.       name:
  3093.         type: string
  3094.         description: уникальное название жанра
  3095.  
  3096.   Regions-details:
  3097.     type: object
  3098.     properties:
  3099.       id:
  3100.         type: string
  3101.         description: уникальный ID региона
  3102.       name:
  3103.         type: string
  3104.         description: уникальное название региона
  3105.       description:
  3106.         type: string
  3107.         description: Полное название региона
  3108.  
  3109.   Session-token-recovery:
  3110.     type: object
  3111.     properties:
  3112.       cm_token:
  3113.         type: string
  3114.         default: "dcxqxEwPGvY:APA91bFiDo6JK72JpwtvsNLJdWcQjRMH4BND9FiCLMXdty315vpZqx4KJl4h1Wxy-82aF3BB8_L9sgB0N3FJYFfceB7E1c3qlm2eXHyKMq5LNApVQ9ju5oifqB179zJ7FjPYM2XNvQV2"
  3115.         description: токен GCM или iCloud Message
  3116.        
  3117.   Elements-of-the-listening-statistics:
  3118.     type: object
  3119.     properties:
  3120.       data:
  3121.         type: object
  3122.         properties:
  3123.           asset_id:
  3124.             type: string
  3125.             description: ID проигрываемой сущности (uuid)
  3126.             default: "96707d2d-cfae-d4e2-6e84-2ac992b5cf5e"
  3127.           duration:
  3128.             type: integer
  3129.             format: int32
  3130.             description: Длительность песни, сек
  3131.             default: 275
  3132.           listenTime:
  3133.             type: integer
  3134.             format: int32
  3135.             description: Уникальное проигранное время, сек
  3136.             default: 125
  3137.           region_id:
  3138.             type: string
  3139.             description: ID региона в котором была прослушана песня
  3140.             default: "csNMZVQBhJ2KCnYFvJ0dnQ=="
  3141.           skippedAt:
  3142.             type: integer
  3143.             format: int32
  3144.             description: В какую секунду был сделан skip
  3145.             default: 0
  3146.           software_id:
  3147.             type: string
  3148.             description: Software bundle ID
  3149.             default: "Aep/aSIBzFVQIrke4h2DxLdV8xl9T32l7BrNkjMkOpk="
  3150.           totalListenTime:
  3151.             type: integer
  3152.             format: int32
  3153.             description: Общее время проигрывания трека, сек
  3154.             default: 125
  3155.           user_id:
  3156.             type: string
  3157.             description: ID пользователя (uuid)
  3158.             default: "sgNa77aLRCXY2Vl5nj+jzQ=="
  3159.           timestamp:
  3160.             type: string
  3161.             description: Время генерации статистических данных на устройстве (завершение проигрывания). Формат времени ISO-8601.
  3162.             default: "2017-02-13T10:02:42+05:00"
  3163.           output_device:
  3164.             type: integer
  3165.             format: int32
  3166.             description: Источник звучания (1 - Наушники 2 - Колонки 3 - Bluetooth device)
  3167.             default: 2
  3168.       type:
  3169.         type: integer
  3170.         format: int32
  3171.         default: 1
  3172. #       decription: является ли песня прослушанной по достижению порога для засчитывания       прослушивания трека 80% - порог. 1 - прослушан, 2 - не прослушан
  3173.       version:
  3174.         type: string
  3175.         default: "1.1"
  3176. #       decription: Каждый уровень берет поле version и приписывает к концу строки свою версию через точку. Пример: Из уровня Core в уровень Application приходит версия: "1". Уровень Application имеет версию "2", поэтому он [уровень] расширяет версию до "1.2". Версия "1.2" отправляется на сервер, который имеет версию "3". Сервер расширяет версию до "1.2.3" и сохраняет в хранилище.
  3177.        
  3178.   User-sessions-details:
  3179.     type: object
  3180.     properties:
  3181.       user_id:
  3182.         type: string
  3183.         description: ID пользователя
  3184.       token:
  3185.         type: string
  3186.         description: токен пользователя для одной сессии
  3187.       created_at:
  3188.         type: integer
  3189.         format: int32
  3190.         description: дата создания сессии пользователя
  3191.       updated_at:
  3192.         type: integer
  3193.         format: int32
  3194.         description: дата обновления сессии пользователя
  3195.       ip:
  3196.         type: string
  3197.         description: GEOIP пользователя для сессии
  3198.       model:
  3199.         type: string
  3200.         description: модель устройства пользователя для сессии
  3201.       make:
  3202.         type: string
  3203.         description: Производитель устройства пользователя для сессии
  3204.       platform:
  3205.         type: string
  3206.         description: Тип ОС устройства пользователя для сессии
  3207.       platform_version:
  3208.         type: string
  3209.         description: Версия ОС устройства пользователя для сессии
  3210.       cm_token:
  3211.         type: string
  3212.         description: токен GCM или iCloud Message
  3213.  
  3214. #               ====================  PERMISSION  ====================
  3215.  
  3216.   Role-with-Permission:
  3217.     type: object
  3218.     properties:
  3219.       Guest-permission:
  3220.         type: array
  3221.         items:
  3222.           $ref: "#/definitions/Guest-permission"
  3223.       User-permission:
  3224.         type: array
  3225.         items:
  3226.           $ref: "#/definitions/User-permission"
  3227.       Moderator-permission:
  3228.         type: array
  3229.         items:
  3230.           $ref: "#/definitions/Moderator-permission"
  3231.       Publisher-permission:
  3232.         type: array
  3233.         items:
  3234.           $ref: "#/definitions/Publisher-permission"
  3235.       Administrator-permission:
  3236.         type: array
  3237.         items:
  3238.           $ref: "#/definitions/Administrator-permission"
  3239.       Restricted-permission:
  3240.         type: array
  3241.         items:
  3242.           $ref: "#/definitions/Restricted-permission"
  3243.  
  3244.   Permission:
  3245.     type: object
  3246.     properties:
  3247.       restricted_region:
  3248.         type: object
  3249.         properties:
  3250.           type:
  3251.             type: integer
  3252.             format: int32
  3253.             default: 2
  3254.             description: ХЗ что это
  3255.           name:
  3256.             type: string
  3257.             default: "restricted_region"
  3258.             description: Название разрешения для роли
  3259.           description:
  3260.             type: string
  3261.             default: "an see entites in restricted region"
  3262.             description: описание разрешения для роли
  3263.           ruleName:
  3264.             type: string
  3265.             default: "null"
  3266.             description: ХЗ что это (название правила)
  3267.           data:
  3268.             type: string
  3269.             default: "null"
  3270.             description: ХЗ что это
  3271.           created_at:
  3272.             type: integer
  3273.             format: int32
  3274.             default: 1487145472
  3275.             description: дата создания разрешения
  3276.           updated_at:
  3277.             type: integer
  3278.             format: int32
  3279.             default: 1487145472
  3280.             description: дата обновления разрешения
  3281.       user_update:
  3282.         type: object
  3283.         properties:
  3284.           type:
  3285.             type: integer
  3286.             format: int32
  3287.             default: 2
  3288.             description: ХЗ что это
  3289.           name:
  3290.             type: string
  3291.             default: "user_update"
  3292.             description: Название разрешения для роли
  3293.           description:
  3294.             type: string
  3295.             default: "Update user"
  3296.             description: описание разрешения для роли
  3297.           ruleName:
  3298.             type: string
  3299.             default: "canUpdateUserProfile"
  3300.             description: ХЗ что это (название правила)
  3301.           data:
  3302.             type: string
  3303.             default: "null"
  3304.             description: ХЗ что это
  3305.           created_at:
  3306.             type: integer
  3307.             format: int32
  3308.             default: 1487145472
  3309.             description: дата создания разрешения
  3310.           updated_at:
  3311.             type: integer
  3312.             format: int32
  3313.             default: 1487145472
  3314.             description: дата обновления разрешения
  3315.       Guest:
  3316.         type: object
  3317.         properties:
  3318.           type:
  3319.             type: integer
  3320.             format: int32
  3321.             default: 1
  3322.             description: ХЗ что это
  3323.           name:
  3324.             type: string
  3325.             default: "Guest"
  3326.             description: Название разрешения для роли
  3327.           description:
  3328.             type: string
  3329.             default: "Guest"
  3330.             description: Описание разрешения для роли
  3331.           ruleName:
  3332.             type: string
  3333.             default: "null"
  3334.             description: ХЗ что это
  3335.           data:
  3336.             type: string
  3337.             default: "null"
  3338.             description: ХЗ что это
  3339.           created_at:
  3340.             type: integer
  3341.             format: int32
  3342.             default: 1487145472
  3343.             description: дата создания разрешения
  3344.           updated_at:
  3345.             type: integer
  3346.             format: int32
  3347.             default: 1487145472
  3348.             description: дата обновления разрешения
  3349.       User:
  3350.         type: object
  3351.         properties:
  3352.           type:
  3353.             type: integer
  3354.             format: int32
  3355.             default: 1
  3356.             description: ХЗ что это
  3357.           name:
  3358.             type: string
  3359.             default: "User"
  3360.             description: Название разрешения для роли
  3361.           description:
  3362.             type: string
  3363.             default: "User"
  3364.             description: Описание разрешения для роли
  3365.           ruleName:
  3366.             type: string
  3367.             default: "null"
  3368.             description: ХЗ что это
  3369.           data:
  3370.             type: string
  3371.             default: "null"
  3372.             description: ХЗ что это
  3373.           created_at:
  3374.             type: integer
  3375.             format: int32
  3376.             default: 1487145472
  3377.             description: дата создания разрешения
  3378.           updated_at:
  3379.             type: integer
  3380.             format: int32
  3381.             default: 1487145472
  3382.             description: дата обновления разрешения
  3383.       Moderator:
  3384.         type: object
  3385.         properties:
  3386.           type:
  3387.             type: integer
  3388.             format: int32
  3389.             default: 1
  3390.             description: ХЗ что это
  3391.           name:
  3392.             type: string
  3393.             default: "Moderator"
  3394.             description: Название разрешения для роли
  3395.           description:
  3396.             type: string
  3397.             default: "Moderator"
  3398.             description: Описание разрешения для роли
  3399.           ruleName:
  3400.             type: string
  3401.             default: "null"
  3402.             description: ХЗ что это
  3403.           data:
  3404.             type: string
  3405.             default: "null"
  3406.             description: ХЗ что это
  3407.           created_at:
  3408.             type: integer
  3409.             format: int32
  3410.             default: 1487145472
  3411.             description: дата создания разрешения
  3412.           updated_at:
  3413.             type: integer
  3414.             format: int32
  3415.             default: 1487145472
  3416.             description: дата обновления разрешения
  3417.       Publisher:
  3418.         type: object
  3419.         properties:
  3420.           type:
  3421.             type: integer
  3422.             format: int32
  3423.             default: 1
  3424.             description: ХЗ что это
  3425.           name:
  3426.             type: string
  3427.             default: "Publisher"
  3428.             description: Название разрешения для роли
  3429.           description:
  3430.             type: string
  3431.             default: "Publisher"
  3432.             description: Описание разрешения для роли
  3433.           ruleName:
  3434.             type: string
  3435.             default: "null"
  3436.             description: ХЗ что это
  3437.           data:
  3438.             type: string
  3439.             default: "null"
  3440.             description: ХЗ что это
  3441.           created_at:
  3442.             type: integer
  3443.             format: int32
  3444.             default: 1487145472
  3445.             description: дата создания разрешения
  3446.           updated_at:
  3447.             type: integer
  3448.             format: int32
  3449.             default: 1487145472
  3450.             description: дата обновления разрешения
  3451. # необходимо дописать список разрешений GET /users/permission/permission: (29 всего в ответе)    
  3452.  
  3453.   Guest-permission:
  3454.     type: object
  3455.     properties:
  3456.       playlist_read:
  3457.         type: object
  3458.         properties:
  3459.           type:
  3460.             type: integer
  3461.             format: int32
  3462.             default: 2
  3463.             description: ХЗ что это
  3464.           name:
  3465.             type: string
  3466.             default: "playlist_read"
  3467.             description: Название разрешения для роли
  3468.           description:
  3469.             type: string
  3470.             default: "Read playlist"
  3471.             description: описание разрешения для роли
  3472.           ruleName:
  3473.             type: string
  3474.             default: "null"
  3475.             description: ХЗ что это
  3476.           data:
  3477.             type: string
  3478.             default: "null"
  3479.             description: ХЗ что это
  3480.           created_at:
  3481.             type: integer
  3482.             format: int32
  3483.             default: 1487145472
  3484.             description: дата создания разрешения
  3485.           updated_at:
  3486.             type: integer
  3487.             format: int32
  3488.             default: 1487145472
  3489.             description: дата обновления разрешения
  3490.       category_read:
  3491.         type: object
  3492.         properties:
  3493.           type:
  3494.             type: integer
  3495.             format: int32
  3496.             default: 2
  3497.             description: ХЗ что это
  3498.           name:
  3499.             type: string
  3500.             default: "category_read"
  3501.             description: Название разрешения для роли
  3502.           description:
  3503.             type: string
  3504.             default: "Read category"
  3505.             description: описание разрешения для роли
  3506.           ruleName:
  3507.             type: string
  3508.             default: "null"
  3509.             description: ХЗ что это
  3510.           data:
  3511.             type: string
  3512.             default: "null"
  3513.             description: ХЗ что это
  3514.           created_at:
  3515.             type: integer
  3516.             format: int32
  3517.             default: 1487145472
  3518.             description: дата создания разрешения
  3519.           updated_at:
  3520.             type: integer
  3521.             format: int32
  3522.             default: 1487145472
  3523.             description: дата обновления разрешения
  3524.       artist_read:
  3525.         type: object
  3526.         properties:
  3527.           type:
  3528.             type: integer
  3529.             format: int32
  3530.             default: 2
  3531.             description: ХЗ что это
  3532.           name:
  3533.             type: string
  3534.             default: "artist_read"
  3535.             description: Название разрешения для роли
  3536.           description:
  3537.             type: string
  3538.             default: "Read artist"
  3539.             description: описание разрешения для роли
  3540.           ruleName:
  3541.             type: string
  3542.             default: "null"
  3543.             description: ХЗ что это
  3544.           data:
  3545.             type: string
  3546.             default: "null"
  3547.             description: ХЗ что это
  3548.           created_at:
  3549.             type: integer
  3550.             format: int32
  3551.             default: 1487145472
  3552.             description: дата создания разрешения
  3553.           updated_at:
  3554.             type: integer
  3555.             format: int32
  3556.             default: 1487145472
  3557.             description: дата обновления разрешения
  3558.       genre_read:
  3559.         type: object
  3560.         properties:
  3561.           type:
  3562.             type: integer
  3563.             format: int32
  3564.             default: 2
  3565.             description: ХЗ что это
  3566.           name:
  3567.             type: string
  3568.             default: "genre_read"
  3569.             description: Название разрешения для роли
  3570.           description:
  3571.             type: string
  3572.             default: "Read genre"
  3573.             description: описание разрешения для роли
  3574.           ruleName:
  3575.             type: string
  3576.             default: "null"
  3577.             description: ХЗ что это
  3578.           data:
  3579.             type: string
  3580.             default: "null"
  3581.             description: ХЗ что это
  3582.           created_at:
  3583.             type: integer
  3584.             format: int32
  3585.             default: 1487145472
  3586.             description: дата создания разрешения
  3587.           updated_at:
  3588.             type: integer
  3589.             format: int32
  3590.             default: 1487145472
  3591.             description: дата обновления разрешения
  3592.       song_read:
  3593.         type: object
  3594.         properties:
  3595.           type:
  3596.             type: integer
  3597.             format: int32
  3598.             default: 2
  3599.             description: ХЗ что это
  3600.           name:
  3601.             type: string
  3602.             default: "song_read"
  3603.             description: Название разрешения для роли
  3604.           description:
  3605.             type: string
  3606.             default: "Read song"
  3607.             description: описание разрешения для роли
  3608.           ruleName:
  3609.             type: string
  3610.             default: "null"
  3611.             description: ХЗ что это
  3612.           data:
  3613.             type: string
  3614.             default: "null"
  3615.             description: ХЗ что это
  3616.           created_at:
  3617.             type: integer
  3618.             format: int32
  3619.             default: 1487145472
  3620.             description: дата создания разрешения
  3621.           updated_at:
  3622.             type: integer
  3623.             format: int32
  3624.             default: 1487145472
  3625.             description: дата обновления разрешения
  3626.          
  3627.   User-permission:
  3628.     type: object
  3629.     properties:
  3630.       Guest:
  3631.         type: object
  3632.         properties:
  3633.           type:
  3634.             type: integer
  3635.             format: int32
  3636.             default: 1
  3637.             description: ХЗ что это
  3638.           name:
  3639.             type: string
  3640.             default: "Guest"
  3641.             description: Название разрешения для роли
  3642.           description:
  3643.             type: string
  3644.             default: "Guest"
  3645.             description: Описание разрешения для роли
  3646.           ruleName:
  3647.             type: string
  3648.             default: "null"
  3649.             description: ХЗ что это
  3650.           data:
  3651.             type: string
  3652.             default: "null"
  3653.             description: ХЗ что это
  3654.           created_at:
  3655.             type: integer
  3656.             format: int32
  3657.             default: 1487145472
  3658.             description: дата создания разрешения
  3659.           updated_at:
  3660.             type: integer
  3661.             format: int32
  3662.             default: 1487145472
  3663.             description: дата обновления разрешения
  3664.       playlist_create:
  3665.         type: object
  3666.         properties:
  3667.           type:
  3668.             type: integer
  3669.             format: int32
  3670.             default: 2
  3671.             description: ХЗ что это
  3672.           name:
  3673.             type: string
  3674.             default: "playlist_create"
  3675.             description: Название разрешения для роли
  3676.           description:
  3677.             type: string
  3678.             default: "Create playlist"
  3679.             description: описание разрешения для роли
  3680.           ruleName:
  3681.             type: string
  3682.             default: "canCreatePlaylist"
  3683.             description: ХЗ что это (название правила)
  3684.           data:
  3685.             type: string
  3686.             default: "null"
  3687.             description: ХЗ что это
  3688.           created_at:
  3689.             type: integer
  3690.             format: int32
  3691.             default: 1487145472
  3692.             description: дата создания разрешения
  3693.           updated_at:
  3694.             type: integer
  3695.             format: int32
  3696.             default: 1487145472
  3697.             description: дата обновления разрешения
  3698.       playlist_delete:
  3699.         type: object
  3700.         properties:
  3701.           type:
  3702.             type: integer
  3703.             format: int32
  3704.             default: 2
  3705.             description: ХЗ что это
  3706.           name:
  3707.             type: string
  3708.             default: "playlist_delete"
  3709.             description: Название разрешения для роли
  3710.           description:
  3711.             type: string
  3712.             default: "Delete playlist"
  3713.             description: описание разрешения для роли
  3714.           ruleName:
  3715.             type: string
  3716.             default: "isAuthor"
  3717.             description: ХЗ что это (название правила)
  3718.           data:
  3719.             type: string
  3720.             default: "null"
  3721.             description: ХЗ что это
  3722.           created_at:
  3723.             type: integer
  3724.             format: int32
  3725.             default: 1487145472
  3726.             description: дата создания разрешения
  3727.           updated_at:
  3728.             type: integer
  3729.             format: int32
  3730.             default: 1487145472
  3731.             description: дата обновления разрешения
  3732.       playlist_update:
  3733.         type: object
  3734.         properties:
  3735.           type:
  3736.             type: integer
  3737.             format: int32
  3738.             default: 2
  3739.             description: ХЗ что это
  3740.           name:
  3741.             type: string
  3742.             default: "playlist_update"
  3743.             description: Название разрешения для роли
  3744.           description:
  3745.             type: string
  3746.             default: "Update playlist"
  3747.             description: описание разрешения для роли
  3748.           ruleName:
  3749.             type: string
  3750.             default: "isAuthor"
  3751.             description: ХЗ что это (название правила)
  3752.           data:
  3753.             type: string
  3754.             default: "null"
  3755.             description: ХЗ что это
  3756.           created_at:
  3757.             type: integer
  3758.             format: int32
  3759.             default: 1487145472
  3760.             description: дата создания разрешения
  3761.           updated_at:
  3762.             type: integer
  3763.             format: int32
  3764.             default: 1487145472
  3765.             description: дата обновления разрешения
  3766.       user_update:
  3767.         type: object
  3768.         properties:
  3769.           type:
  3770.             type: integer
  3771.             format: int32
  3772.             default: 2
  3773.             description: ХЗ что это
  3774.           name:
  3775.             type: string
  3776.             default: "user_update"
  3777.             description: Название разрешения для роли
  3778.           description:
  3779.             type: string
  3780.             default: "Update user"
  3781.             description: описание разрешения для роли
  3782.           ruleName:
  3783.             type: string
  3784.             default: "canUpdateUserProfile"
  3785.             description: ХЗ что это (название правила)
  3786.           data:
  3787.             type: string
  3788.             default: "null"
  3789.             description: ХЗ что это
  3790.           created_at:
  3791.             type: integer
  3792.             format: int32
  3793.             default: 1487145472
  3794.             description: дата создания разрешения
  3795.           updated_at:
  3796.             type: integer
  3797.             format: int32
  3798.             default: 1487145472
  3799.             description: дата обновления разрешения
  3800.       analitics_create:
  3801.         type: object
  3802.         properties:
  3803.           type:
  3804.             type: integer
  3805.             format: int32
  3806.             default: 2
  3807.             description: ХЗ что это
  3808.           name:
  3809.             type: string
  3810.             default: "analytics_create"
  3811.             description: Название разрешения для роли
  3812.           description:
  3813.             type: string
  3814.             default: "Save analytics data"
  3815.             description: описание разрешения для роли
  3816.           ruleName:
  3817.             type: string
  3818.             default: "null"
  3819.             description: ХЗ что это (название правила)
  3820.           data:
  3821.             type: string
  3822.             default: "null"
  3823.             description: ХЗ что это
  3824.           created_at:
  3825.             type: integer
  3826.             format: int32
  3827.             default: 1487145472
  3828.             description: дата создания разрешения
  3829.           updated_at:
  3830.             type: integer
  3831.             format: int32
  3832.             default: 1487145472
  3833.             description: дата обновления разрешения
  3834.  
  3835.   Moderator-permission:
  3836.     type: object
  3837.     properties:
  3838.       User:
  3839.         type: object
  3840.         properties:
  3841.           type:
  3842.             type: integer
  3843.             format: int32
  3844.             default: 1
  3845.             description: ХЗ что это
  3846.           name:
  3847.             type: string
  3848.             default: "User"
  3849.             description: Название разрешения для роли
  3850.           description:
  3851.             type: string
  3852.             default: "User"
  3853.             description: Описание разрешения для роли
  3854.           ruleName:
  3855.             type: string
  3856.             default: "null"
  3857.             description: ХЗ что это
  3858.           data:
  3859.             type: string
  3860.             default: "null"
  3861.             description: ХЗ что это
  3862.           created_at:
  3863.             type: integer
  3864.             format: int32
  3865.             default: 1487145472
  3866.             description: дата создания разрешения
  3867.           updated_at:
  3868.             type: integer
  3869.             format: int32
  3870.             default: 1487145472
  3871.             description: дата обновления разрешения
  3872.       category_create:
  3873.         type: object
  3874.         properties:
  3875.           type:
  3876.             type: integer
  3877.             format: int32
  3878.             default: 2
  3879.             description: ХЗ что это
  3880.           name:
  3881.             type: string
  3882.             default: "category_create"
  3883.             description: Название разрешения для роли
  3884.           description:
  3885.             type: string
  3886.             default: "Create category"
  3887.             description: описание разрешения для роли
  3888.           ruleName:
  3889.             type: string
  3890.             default: "null"
  3891.             description: ХЗ что это
  3892.           data:
  3893.             type: string
  3894.             default: "null"
  3895.             description: ХЗ что это
  3896.           created_at:
  3897.             type: integer
  3898.             format: int32
  3899.             default: 1487145472
  3900.             description: дата создания разрешения
  3901.           updated_at:
  3902.             type: integer
  3903.             format: int32
  3904.             default: 1487145472
  3905.             description: дата обновления разрешения
  3906.       category_delete:
  3907.         type: object
  3908.         properties:
  3909.           type:
  3910.             type: integer
  3911.             format: int32
  3912.             default: 2
  3913.             description: ХЗ что это
  3914.           name:
  3915.             type: string
  3916.             default: "category_delete"
  3917.             description: Название разрешения для роли
  3918.           description:
  3919.             type: string
  3920.             default: "Delete category"
  3921.             description: описание разрешения для роли
  3922.           ruleName:
  3923.             type: string
  3924.             default: "null"
  3925.             description: ХЗ что это
  3926.           data:
  3927.             type: string
  3928.             default: "null"
  3929.             description: ХЗ что это
  3930.           created_at:
  3931.             type: integer
  3932.             format: int32
  3933.             default: 1487145472
  3934.             description: дата создания разрешения
  3935.           updated_at:
  3936.             type: integer
  3937.             format: int32
  3938.             default: 1487145472
  3939.             description: дата обновления разрешения
  3940.       category_update:
  3941.         type: object
  3942.         properties:
  3943.           type:
  3944.             type: integer
  3945.             format: int32
  3946.             default: 2
  3947.             description: ХЗ что это
  3948.           name:
  3949.             type: string
  3950.             default: "category_update"
  3951.             description: Название разрешения для роли
  3952.           description:
  3953.             type: string
  3954.             default: "Update category"
  3955.             description: описание разрешения для роли
  3956.           ruleName:
  3957.             type: string
  3958.             default: "null"
  3959.             description: ХЗ что это
  3960.           data:
  3961.             type: string
  3962.             default: "null"
  3963.             description: ХЗ что это
  3964.           created_at:
  3965.             type: integer
  3966.             format: int32
  3967.             default: 1487145472
  3968.             description: дата создания разрешения
  3969.           updated_at:
  3970.             type: integer
  3971.             format: int32
  3972.             default: 1487145472
  3973.             description: дата обновления разрешения
  3974.       artist_create:
  3975.         type: object
  3976.         properties:
  3977.           type:
  3978.             type: integer
  3979.             format: int32
  3980.             default: 2
  3981.             description: ХЗ что это
  3982.           name:
  3983.             type: string
  3984.             default: "artist_create"
  3985.             description: Название разрешения для роли
  3986.           description:
  3987.             type: string
  3988.             default: "Create artist"
  3989.             description: описание разрешения для роли
  3990.           ruleName:
  3991.             type: string
  3992.             default: "null"
  3993.             description: ХЗ что это
  3994.           data:
  3995.             type: string
  3996.             default: "null"
  3997.             description: ХЗ что это
  3998.           created_at:
  3999.             type: integer
  4000.             format: int32
  4001.             default: 1487145472
  4002.             description: дата создания разрешения
  4003.           updated_at:
  4004.             type: integer
  4005.             format: int32
  4006.             default: 1487145472
  4007.             description: дата обновления разрешения
  4008.       artist_delete:
  4009.         type: object
  4010.         properties:
  4011.           type:
  4012.             type: integer
  4013.             format: int32
  4014.             default: 2
  4015.             description: ХЗ что это
  4016.           name:
  4017.             type: string
  4018.             default: "artist_delete"
  4019.             description: Название разрешения для роли
  4020.           description:
  4021.             type: string
  4022.             default: "Delete artist"
  4023.             description: описание разрешения для роли
  4024.           ruleName:
  4025.             type: string
  4026.             default: "null"
  4027.             description: ХЗ что это
  4028.           data:
  4029.             type: string
  4030.             default: "null"
  4031.             description: ХЗ что это
  4032.           created_at:
  4033.             type: integer
  4034.             format: int32
  4035.             default: 1487145472
  4036.             description: дата создания разрешения
  4037.           updated_at:
  4038.             type: integer
  4039.             format: int32
  4040.             default: 1487145472
  4041.             description: дата обновления разрешения
  4042.       artist_update:
  4043.         type: object
  4044.         properties:
  4045.           type:
  4046.             type: integer
  4047.             format: int32
  4048.             default: 2
  4049.             description: ХЗ что это
  4050.           name:
  4051.             type: string
  4052.             default: "artist_update"
  4053.             description: Название разрешения для роли
  4054.           description:
  4055.             type: string
  4056.             default: "Update artist"
  4057.             description: описание разрешения для роли
  4058.           ruleName:
  4059.             type: string
  4060.             default: "null"
  4061.             description: ХЗ что это
  4062.           data:
  4063.             type: string
  4064.             default: "null"
  4065.             description: ХЗ что это
  4066.           created_at:
  4067.             type: integer
  4068.             format: int32
  4069.             default: 1487145472
  4070.             description: дата создания разрешения
  4071.           updated_at:
  4072.             type: integer
  4073.             format: int32
  4074.             default: 1487145472
  4075.             description: дата обновления разрешения
  4076.       genre_create:
  4077.         type: object
  4078.         properties:
  4079.           type:
  4080.             type: integer
  4081.             format: int32
  4082.             default: 2
  4083.             description: ХЗ что это
  4084.           name:
  4085.             type: string
  4086.             default: "genre_create"
  4087.             description: Название разрешения для роли
  4088.           description:
  4089.             type: string
  4090.             default: "Create genre"
  4091.             description: описание разрешения для роли
  4092.           ruleName:
  4093.             type: string
  4094.             default: "null"
  4095.             description: ХЗ что это
  4096.           data:
  4097.             type: string
  4098.             default: "null"
  4099.             description: ХЗ что это
  4100.           created_at:
  4101.             type: integer
  4102.             format: int32
  4103.             default: 1487145472
  4104.             description: дата создания разрешения
  4105.           updated_at:
  4106.             type: integer
  4107.             format: int32
  4108.             default: 1487145472
  4109.             description: дата обновления разрешения
  4110.       genre_delete:
  4111.         type: object
  4112.         properties:
  4113.           type:
  4114.             type: integer
  4115.             format: int32
  4116.             default: 2
  4117.             description: ХЗ что это
  4118.           name:
  4119.             type: string
  4120.             default: "genre_delete"
  4121.             description: Название разрешения для роли
  4122.           description:
  4123.             type: string
  4124.             default: "Delete genre"
  4125.             description: описание разрешения для роли
  4126.           ruleName:
  4127.             type: string
  4128.             default: "null"
  4129.             description: ХЗ что это
  4130.           data:
  4131.             type: string
  4132.             default: "null"
  4133.             description: ХЗ что это
  4134.           created_at:
  4135.             type: integer
  4136.             format: int32
  4137.             default: 1487145472
  4138.             description: дата создания разрешения
  4139.           updated_at:
  4140.             type: integer
  4141.             format: int32
  4142.             default: 1487145472
  4143.             description: дата обновления разрешения
  4144.       genre_update:
  4145.         type: object
  4146.         properties:
  4147.           type:
  4148.             type: integer
  4149.             format: int32
  4150.             default: 2
  4151.             description: ХЗ что это
  4152.           name:
  4153.             type: string
  4154.             default: "genre_update"
  4155.             description: Название разрешения для роли
  4156.           description:
  4157.             type: string
  4158.             default: "Update genre"
  4159.             description: описание разрешения для роли
  4160.           ruleName:
  4161.             type: string
  4162.             default: "null"
  4163.             description: ХЗ что это
  4164.           data:
  4165.             type: string
  4166.             default: "null"
  4167.             description: ХЗ что это
  4168.           created_at:
  4169.             type: integer
  4170.             format: int32
  4171.             default: 1487145472
  4172.             description: дата создания разрешения
  4173.           updated_at:
  4174.             type: integer
  4175.             format: int32
  4176.             default: 1487145472
  4177.             description: дата обновления разрешения
  4178.       song_create:
  4179.         type: object
  4180.         properties:
  4181.           type:
  4182.             type: integer
  4183.             format: int32
  4184.             default: 2
  4185.             description: ХЗ что это
  4186.           name:
  4187.             type: string
  4188.             default: "song_create"
  4189.             description: Название разрешения для роли
  4190.           description:
  4191.             type: string
  4192.             default: "Create song"
  4193.             description: описание разрешения для роли
  4194.           ruleName:
  4195.             type: string
  4196.             default: "null"
  4197.             description: ХЗ что это
  4198.           data:
  4199.             type: string
  4200.             default: "null"
  4201.             description: ХЗ что это
  4202.           created_at:
  4203.             type: integer
  4204.             format: int32
  4205.             default: 1487145472
  4206.             description: дата создания разрешения
  4207.           updated_at:
  4208.             type: integer
  4209.             format: int32
  4210.             default: 1487145472
  4211.             description: дата обновления разрешения
  4212.       song_delete:
  4213.         type: object
  4214.         properties:
  4215.           type:
  4216.             type: integer
  4217.             format: int32
  4218.             default: 2
  4219.             description: ХЗ что это
  4220.           name:
  4221.             type: string
  4222.             default: "song_delete"
  4223.             description: Название разрешения для роли
  4224.           description:
  4225.             type: string
  4226.             default: "Delete song"
  4227.             description: описание разрешения для роли
  4228.           ruleName:
  4229.             type: string
  4230.             default: "null"
  4231.             description: ХЗ что это
  4232.           data:
  4233.             type: string
  4234.             default: "null"
  4235.             description: ХЗ что это
  4236.           created_at:
  4237.             type: integer
  4238.             format: int32
  4239.             default: 1487145472
  4240.             description: дата создания разрешения
  4241.           updated_at:
  4242.             type: integer
  4243.             format: int32
  4244.             default: 1487145472
  4245.             description: дата обновления разрешения
  4246.       song_update:
  4247.         type: object
  4248.         properties:
  4249.           type:
  4250.             type: integer
  4251.             format: int32
  4252.             default: 2
  4253.             description: ХЗ что это
  4254.           name:
  4255.             type: string
  4256.             default: "song_update"
  4257.             description: Название разрешения для роли
  4258.           description:
  4259.             type: string
  4260.             default: "Update song"
  4261.             description: описание разрешения для роли
  4262.           ruleName:
  4263.             type: string
  4264.             default: "null"
  4265.             description: ХЗ что это
  4266.           data:
  4267.             type: string
  4268.             default: "null"
  4269.             description: ХЗ что это
  4270.           created_at:
  4271.             type: integer
  4272.             format: int32
  4273.             default: 1487145472
  4274.             description: дата создания разрешения
  4275.           updated_at:
  4276.             type: integer
  4277.             format: int32
  4278.             default: 1487145472
  4279.             description: дата обновления разрешения
  4280.       user_create:
  4281.         type: object
  4282.         properties:
  4283.           type:
  4284.             type: integer
  4285.             format: int32
  4286.             default: 2
  4287.             description: ХЗ что это
  4288.           name:
  4289.             type: string
  4290.             default: "user_create"
  4291.             description: Название разрешения для роли
  4292.           description:
  4293.             type: string
  4294.             default: "Create user"
  4295.             description: описание разрешения для роли
  4296.           ruleName:
  4297.             type: string
  4298.             default: "null"
  4299.             description: ХЗ что это (название правила)
  4300.           data:
  4301.             type: string
  4302.             default: "null"
  4303.             description: ХЗ что это
  4304.           created_at:
  4305.             type: integer
  4306.             format: int32
  4307.             default: 1487145472
  4308.             description: дата создания разрешения
  4309.           updated_at:
  4310.             type: integer
  4311.             format: int32
  4312.             default: 1487145472
  4313.             description: дата обновления разрешения
  4314.       user_read:
  4315.         type: object
  4316.         properties:
  4317.           type:
  4318.             type: integer
  4319.             format: int32
  4320.             default: 2
  4321.             description: ХЗ что это
  4322.           name:
  4323.             type: string
  4324.             default: "user_read"
  4325.             description: Название разрешения для роли
  4326.           description:
  4327.             type: string
  4328.             default: "Read user"
  4329.             description: описание разрешения для роли
  4330.           ruleName:
  4331.             type: string
  4332.             default: "null"
  4333.             description: ХЗ что это (название правила)
  4334.           data:
  4335.             type: string
  4336.             default: "null"
  4337.             description: ХЗ что это
  4338.           created_at:
  4339.             type: integer
  4340.             format: int32
  4341.             default: 1487145472
  4342.             description: дата создания разрешения
  4343.           updated_at:
  4344.             type: integer
  4345.             format: int32
  4346.             default: 1487145472
  4347.             description: дата обновления разрешения
  4348.       notification:
  4349.         type: object
  4350.         properties:
  4351.           type:
  4352.             type: integer
  4353.             format: int32
  4354.             default: 2
  4355.             description: ХЗ что это
  4356.           name:
  4357.             type: string
  4358.             default: "notification"
  4359.             description: Название разрешения для роли
  4360.           description:
  4361.             type: string
  4362.             default: "Notification management"
  4363.             description: описание разрешения для роли
  4364.           ruleName:
  4365.             type: string
  4366.             default: "null"
  4367.             description: ХЗ что это (название правила)
  4368.           data:
  4369.             type: string
  4370.             default: "null"
  4371.             description: ХЗ что это
  4372.           created_at:
  4373.             type: integer
  4374.             format: int32
  4375.             default: 1487145472
  4376.             description: дата создания разрешения
  4377.           updated_at:
  4378.             type: integer
  4379.             format: int32
  4380.             default: 1487145472
  4381.             description: дата обновления разрешения
  4382.       analitics_read:
  4383.         type: object
  4384.         properties:
  4385.           type:
  4386.             type: integer
  4387.             format: int32
  4388.             default: 2
  4389.             description: ХЗ что это
  4390.           name:
  4391.             type: string
  4392.             default: "analytics_read"
  4393.             description: Название разрешения для роли
  4394.           description:
  4395.             type: string
  4396.             default: "Reade analytics data"
  4397.             description: описание разрешения для роли
  4398.           ruleName:
  4399.             type: string
  4400.             default: "null"
  4401.             description: ХЗ что это (название правила)
  4402.           data:
  4403.             type: string
  4404.             default: "null"
  4405.             description: ХЗ что это
  4406.           created_at:
  4407.             type: integer
  4408.             format: int32
  4409.             default: 1487145472
  4410.             description: дата создания разрешения
  4411.           updated_at:
  4412.             type: integer
  4413.             format: int32
  4414.             default: 1487145472
  4415.             description: дата обновления разрешения
  4416.       region_create:
  4417.         type: object
  4418.         properties:
  4419.           type:
  4420.             type: integer
  4421.             format: int32
  4422.             default: 2
  4423.             description: ХЗ что это
  4424.           name:
  4425.             type: string
  4426.             default: "region_create"
  4427.             description: Название разрешения для роли
  4428.           description:
  4429.             type: string
  4430.             default: "Create region"
  4431.             description: описание разрешения для роли
  4432.           ruleName:
  4433.             type: string
  4434.             default: "null"
  4435.             description: ХЗ что это (название правила)
  4436.           data:
  4437.             type: string
  4438.             default: "null"
  4439.             description: ХЗ что это
  4440.           created_at:
  4441.             type: integer
  4442.             format: int32
  4443.             default: 1487145472
  4444.             description: дата создания разрешения
  4445.           updated_at:
  4446.             type: integer
  4447.             format: int32
  4448.             default: 1487145472
  4449.             description: дата обновления разрешения
  4450.       region_read:
  4451.         type: object
  4452.         properties:
  4453.           type:
  4454.             type: integer
  4455.             format: int32
  4456.             default: 2
  4457.             description: ХЗ что это
  4458.           name:
  4459.             type: string
  4460.             default: "region_read"
  4461.             description: Название разрешения для роли
  4462.           description:
  4463.             type: string
  4464.             default: "Read region"
  4465.             description: описание разрешения для роли
  4466.           ruleName:
  4467.             type: string
  4468.             default: "null"
  4469.             description: ХЗ что это (название правила)
  4470.           data:
  4471.             type: string
  4472.             default: "null"
  4473.             description: ХЗ что это
  4474.           created_at:
  4475.             type: integer
  4476.             format: int32
  4477.             default: 1487145472
  4478.             description: дата создания разрешения
  4479.           updated_at:
  4480.             type: integer
  4481.             format: int32
  4482.             default: 1487145472
  4483.             description: дата обновления разрешения      
  4484.       region_update:
  4485.         type: object
  4486.         properties:
  4487.           type:
  4488.             type: integer
  4489.             format: int32
  4490.             default: 2
  4491.             description: ХЗ что это
  4492.           name:
  4493.             type: string
  4494.             default: "region_update"
  4495.             description: Название разрешения для роли
  4496.           description:
  4497.             type: string
  4498.             default: "Update region"
  4499.             description: описание разрешения для роли
  4500.           ruleName:
  4501.             type: string
  4502.             default: "null"
  4503.             description: ХЗ что это (название правила)
  4504.           data:
  4505.             type: string
  4506.             default: "null"
  4507.             description: ХЗ что это
  4508.           created_at:
  4509.             type: integer
  4510.             format: int32
  4511.             default: 1487145472
  4512.             description: дата создания разрешения
  4513.           updated_at:
  4514.             type: integer
  4515.             format: int32
  4516.             default: 1487145472
  4517.             description: дата обновления разрешения            
  4518.  
  4519.   Publisher-permission:
  4520.     type: object
  4521.     properties:
  4522.       User:
  4523.         type: object
  4524.         properties:
  4525.           type:
  4526.             type: integer
  4527.             format: int32
  4528.             default: 1
  4529.             description: ХЗ что это
  4530.           name:
  4531.             type: string
  4532.             default: "User"
  4533.             description: Название разрешения для роли
  4534.           description:
  4535.             type: string
  4536.             default: "User"
  4537.             description: Описание разрешения для роли
  4538.           ruleName:
  4539.             type: string
  4540.             default: "null"
  4541.             description: ХЗ что это
  4542.           data:
  4543.             type: string
  4544.             default: "null"
  4545.             description: ХЗ что это
  4546.           created_at:
  4547.             type: integer
  4548.             format: int32
  4549.             default: 1487145472
  4550.             description: дата создания разрешения
  4551.           updated_at:
  4552.             type: integer
  4553.             format: int32
  4554.             default: 1487145472
  4555.             description: дата обновления разрешения
  4556.       artist_create:
  4557.         type: object
  4558.         properties:
  4559.           type:
  4560.             type: integer
  4561.             format: int32
  4562.             default: 2
  4563.             description: ХЗ что это
  4564.           name:
  4565.             type: string
  4566.             default: "artist_create"
  4567.             description: Название разрешения для роли
  4568.           description:
  4569.             type: string
  4570.             default: "Create artist"
  4571.             description: описание разрешения для роли
  4572.           ruleName:
  4573.             type: string
  4574.             default: "null"
  4575.             description: ХЗ что это (название правила)
  4576.           data:
  4577.             type: string
  4578.             default: "null"
  4579.             description: ХЗ что это
  4580.           created_at:
  4581.             type: integer
  4582.             format: int32
  4583.             default: 1487145472
  4584.             description: дата создания разрешения
  4585.           updated_at:
  4586.             type: integer
  4587.             format: int32
  4588.             default: 1487145472
  4589.             description: дата обновления разрешения
  4590.       song_create:
  4591.         type: object
  4592.         properties:
  4593.           type:
  4594.             type: integer
  4595.             format: int32
  4596.             default: 2
  4597.             description: ХЗ что это
  4598.           name:
  4599.             type: string
  4600.             default: "song_create"
  4601.             description: Название разрешения для роли
  4602.           description:
  4603.             type: string
  4604.             default: "Create song"
  4605.             description: описание разрешения для роли
  4606.           ruleName:
  4607.             type: string
  4608.             default: "null"
  4609.             description: ХЗ что это (название правила)
  4610.           data:
  4611.             type: string
  4612.             default: "null"
  4613.             description: ХЗ что это
  4614.           created_at:
  4615.             type: integer
  4616.             format: int32
  4617.             default: 1487145472
  4618.             description: дата создания разрешения
  4619.           updated_at:
  4620.             type: integer
  4621.             format: int32
  4622.             default: 1487145472
  4623.             description: дата обновления разрешения
  4624.       analitics_read:
  4625.         type: object
  4626.         properties:
  4627.           type:
  4628.             type: integer
  4629.             format: int32
  4630.             default: 2
  4631.             description: ХЗ что это
  4632.           name:
  4633.             type: string
  4634.             default: "analytics_read"
  4635.             description: Название разрешения для роли
  4636.           description:
  4637.             type: string
  4638.             default: "Reade analytics data"
  4639.             description: описание разрешения для роли
  4640.           ruleName:
  4641.             type: string
  4642.             default: "null"
  4643.             description: ХЗ что это (название правила)
  4644.           data:
  4645.             type: string
  4646.             default: "null"
  4647.             description: ХЗ что это
  4648.           created_at:
  4649.             type: integer
  4650.             format: int32
  4651.             default: 1487145472
  4652.             description: дата создания разрешения
  4653.           updated_at:
  4654.             type: integer
  4655.             format: int32
  4656.             default: 1487145472
  4657.             description: дата обновления разрешения
  4658.       region_read:
  4659.         type: object
  4660.         properties:
  4661.           type:
  4662.             type: integer
  4663.             format: int32
  4664.             default: 2
  4665.             description: ХЗ что это
  4666.           name:
  4667.             type: string
  4668.             default: "region_read"
  4669.             description: Название разрешения для роли
  4670.           description:
  4671.             type: string
  4672.             default: "Read region"
  4673.             description: описание разрешения для роли
  4674.           ruleName:
  4675.             type: string
  4676.             default: "null"
  4677.             description: ХЗ что это (название правила)
  4678.           data:
  4679.             type: string
  4680.             default: "null"
  4681.             description: ХЗ что это
  4682.           created_at:
  4683.             type: integer
  4684.             format: int32
  4685.             default: 1487145472
  4686.             description: дата создания разрешения
  4687.           updated_at:
  4688.             type: integer
  4689.             format: int32
  4690.             default: 1487145472
  4691.             description: дата обновления разрешения
  4692.            
  4693.   Administrator-permission:
  4694.     type: object
  4695.     properties:  
  4696.       Moderator:
  4697.         type: object
  4698.         properties:
  4699.           type:
  4700.             type: integer
  4701.             format: int32
  4702.             default: 1
  4703.             description: ХЗ что это
  4704.           name:
  4705.             type: string
  4706.             default: "Moderator"
  4707.             description: Название разрешения для роли
  4708.           description:
  4709.             type: string
  4710.             default: "Moderator"
  4711.             description: Описание разрешения для роли
  4712.           ruleName:
  4713.             type: string
  4714.             default: "null"
  4715.             description: ХЗ что это
  4716.           data:
  4717.             type: string
  4718.             default: "null"
  4719.             description: ХЗ что это
  4720.           created_at:
  4721.             type: integer
  4722.             format: int32
  4723.             default: 1487145472
  4724.             description: дата создания разрешения
  4725.           updated_at:
  4726.             type: integer
  4727.             format: int32
  4728.             default: 1487145472
  4729.             description: дата обновления разрешения
  4730.       Publisher:
  4731.         type: object
  4732.         properties:
  4733.           type:
  4734.             type: integer
  4735.             format: int32
  4736.             default: 1
  4737.             description: ХЗ что это
  4738.           name:
  4739.             type: string
  4740.             default: "Publisher"
  4741.             description: Название разрешения для роли
  4742.           description:
  4743.             type: string
  4744.             default: "Publisher"
  4745.             description: Описание разрешения для роли
  4746.           ruleName:
  4747.             type: string
  4748.             default: "null"
  4749.             description: ХЗ что это
  4750.           data:
  4751.             type: string
  4752.             default: "null"
  4753.             description: ХЗ что это
  4754.           created_at:
  4755.             type: integer
  4756.             format: int32
  4757.             default: 1487145472
  4758.             description: дата создания разрешения
  4759.           updated_at:
  4760.             type: integer
  4761.             format: int32
  4762.             default: 1487145472
  4763.             description: дата обновления разрешения
  4764.       restricted_region:
  4765.         type: object
  4766.         properties:
  4767.           type:
  4768.             type: integer
  4769.             format: int32
  4770.             default: 2
  4771.             description: ХЗ что это
  4772.           name:
  4773.             type: string
  4774.             default: "restricted_region"
  4775.             description: Название разрешения для роли
  4776.           description:
  4777.             type: string
  4778.             default: "an see entites in restricted region"
  4779.             description: описание разрешения для роли
  4780.           ruleName:
  4781.             type: string
  4782.             default: "null"
  4783.             description: ХЗ что это (название правила)
  4784.           data:
  4785.             type: string
  4786.             default: "null"
  4787.             description: ХЗ что это
  4788.           created_at:
  4789.             type: integer
  4790.             format: int32
  4791.             default: 1487145472
  4792.             description: дата создания разрешения
  4793.           updated_at:
  4794.             type: integer
  4795.             format: int32
  4796.             default: 1487145472
  4797.             description: дата обновления разрешения      
  4798.       user_delete:
  4799.         type: object
  4800.         properties:
  4801.           type:
  4802.             type: integer
  4803.             format: int32
  4804.             default: 2
  4805.             description: ХЗ что это
  4806.           name:
  4807.             type: string
  4808.             default: "user_delete"
  4809.             description: Название разрешения для роли
  4810.           description:
  4811.             type: string
  4812.             default: "Delete user"
  4813.             description: описание разрешения для роли
  4814.           ruleName:
  4815.             type: string
  4816.             default: "null"
  4817.             description: ХЗ что это (название правила)
  4818.           data:
  4819.             type: string
  4820.             default: "null"
  4821.             description: ХЗ что это
  4822.           created_at:
  4823.             type: integer
  4824.             format: int32
  4825.             default: 1487145472
  4826.             description: дата создания разрешения
  4827.           updated_at:
  4828.             type: integer
  4829.             format: int32
  4830.             default: 1487145472
  4831.             description: дата обновления разрешения      
  4832.       user_role_update:
  4833.         type: object
  4834.         properties:
  4835.           type:
  4836.             type: integer
  4837.             format: int32
  4838.             default: 2
  4839.             description: ХЗ что это
  4840.           name:
  4841.             type: string
  4842.             default: "user_role_update"
  4843.             description: Название разрешения для роли
  4844.           description:
  4845.             type: string
  4846.             default: "Update user role"
  4847.             description: описание разрешения для роли
  4848.           ruleName:
  4849.             type: string
  4850.             default: "canNotChangeOwnRole"
  4851.             description: ХЗ что это (название правила)
  4852.           data:
  4853.             type: string
  4854.             default: "null"
  4855.             description: ХЗ что это
  4856.           created_at:
  4857.             type: integer
  4858.             format: int32
  4859.             default: 1487145472
  4860.             description: дата создания разрешения
  4861.           updated_at:
  4862.             type: integer
  4863.             format: int32
  4864.             default: 1487145472
  4865.             description: дата обновления разрешения          
  4866.       update:
  4867.         type: object
  4868.         properties:
  4869.           type:
  4870.             type: integer
  4871.             format: int32
  4872.             default: 2
  4873.             description: ХЗ что это
  4874.           name:
  4875.             type: string
  4876.             default: "update"
  4877.             description: Название разрешения для роли
  4878.           description:
  4879.             type: string
  4880.             default: "Updates management"
  4881.             description: описание разрешения для роли
  4882.           ruleName:
  4883.             type: string
  4884.             default: "null"
  4885.             description: ХЗ что это (название правила)
  4886.           data:
  4887.             type: string
  4888.             default: "null"
  4889.             description: ХЗ что это
  4890.           created_at:
  4891.             type: integer
  4892.             format: int32
  4893.             default: 1487145472
  4894.             description: дата создания разрешения
  4895.           updated_at:
  4896.             type: integer
  4897.             format: int32
  4898.             default: 1487145472
  4899.             description: дата обновления разрешения
  4900.       region_delete:
  4901.         type: object
  4902.         properties:
  4903.           type:
  4904.             type: integer
  4905.             format: int32
  4906.             default: 2
  4907.             description: ХЗ что это
  4908.           name:
  4909.             type: string
  4910.             default: "region_delete"
  4911.             description: Название разрешения для роли
  4912.           description:
  4913.             type: string
  4914.             default: "Delete region"
  4915.             description: описание разрешения для роли
  4916.           ruleName:
  4917.             type: string
  4918.             default: "null"
  4919.             description: ХЗ что это (название правила)
  4920.           data:
  4921.             type: string
  4922.             default: "null"
  4923.             description: ХЗ что это
  4924.           created_at:
  4925.             type: integer
  4926.             format: int32
  4927.             default: 1487145472
  4928.             description: дата создания разрешения
  4929.           updated_at:
  4930.             type: integer
  4931.             format: int32
  4932.             default: 1487145472
  4933.             description: дата обновления разрешения      
  4934.            
  4935.   Restricted-permission:
  4936.     type: object
  4937.     properties:
  4938.       restricted_region:
  4939.         type: object
  4940.         properties:
  4941.           type:
  4942.             type: integer
  4943.             format: int32
  4944.             default: 2
  4945.             description: ХЗ что это
  4946.           name:
  4947.             type: string
  4948.             default: "restricted_region"
  4949.             description: Название разрешения для роли
  4950.           description:
  4951.             type: string
  4952.             default: "an see entites in restricted region"
  4953.             description: описание разрешения для роли
  4954.           ruleName:
  4955.             type: string
  4956.             default: "null"
  4957.             description: ХЗ что это (название правила)
  4958.           data:
  4959.             type: string
  4960.             default: "null"
  4961.             description: ХЗ что это
  4962.           created_at:
  4963.             type: integer
  4964.             format: int32
  4965.             default: 1487145472
  4966.             description: дата создания разрешения
  4967.           updated_at:
  4968.             type: integer
  4969.             format: int32
  4970.             default: 1487145472
  4971.             description: дата обновления разрешения      
  4972. #               ====================  ADS  ====================
  4973.            
  4974.   ADS-details:
  4975.     type: object
  4976.     properties:
  4977.       id:
  4978.         type: string
  4979.         description: уникальный ID рекламы
  4980.       title:
  4981.         type: string
  4982.         description: уникальное название рекламы
  4983.       description:
  4984.         type: string
  4985.         description: описание для данной рекламы
  4986.       cover:
  4987.         type: string
  4988.         description: линк для иконки данной рекламы
  4989.       representation:
  4990.         type: string
  4991.         description: линк для ядра(плеер) в виде JSON где есть инфо о видах репрезентации (качеств трека)
  4992.       url:
  4993.         type: string
  4994.         description: url адрес на данную рекламу
  4995.       language:
  4996.         type: string
  4997.         description: язык данной рекламы
  4998.       status:
  4999.         type: integer
  5000.         format: int32
  5001.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5002.  
  5003. #               ===============================================        
  5004.  
  5005.   Track-changes-details:
  5006.     type: object
  5007.     properties:
  5008.       id:
  5009.         type: string
  5010.         description: уникальный номер трека в системе
  5011.       title:
  5012.         type: string
  5013.         description: название трека
  5014.       duration:
  5015.         type: integer
  5016.         format: int32
  5017.         description: длина произведения в секундах
  5018.       listen:
  5019.         type: integer
  5020.         format: int32
  5021.         description: количество прослушиваний
  5022.       status:
  5023.         type: integer
  5024.         format: int32
  5025.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5026.       language:
  5027.         type: string
  5028.         description: язык на котором спета песня
  5029.       year:
  5030.         type: integer
  5031.         format: int32
  5032.         description: год выпуска трека, например 2000 (четыре цифры)
  5033.       url:
  5034.         type: string
  5035.         description: сайт откуда взят трек
  5036.       composer:
  5037.         type: string
  5038.         description: кто является композитором, если это классическая музыка.
  5039.       publisher_id:
  5040.         type: string
  5041.         description: уникальный номер правообладаетля в системе
  5042.       country:
  5043.         type: string
  5044.         description: страна где был выпущен этот трек
  5045.       censorship:
  5046.         type: boolean
  5047.         description: если есть мат то пишем true
  5048.       original_artist:
  5049.         type: string
  5050.         description: оригинальный исполнитель трека, если трек является кавером
  5051.       created_at:
  5052.         type: string
  5053.         description: дата загрузки трека в систему
  5054.       updated_at:
  5055.         type: string
  5056.         description: дата, когда были обновлены данные в треке
  5057.       representation:
  5058.         type: string
  5059.         description: линк для ядра(плеер) в виде JSON где есть инфо о видах репрезентации (качеств трека)
  5060.       cover:
  5061.         type: string
  5062.         description: линк на картину трека\альбома. Иногда называется кавер
  5063.       cover_id:
  5064.         type: string
  5065.         description: Айдишка трека, точно незнаю что это
  5066.       likes:
  5067.         type: integer
  5068.         format: int32
  5069.         description: количество нажатых лайков
  5070.       artists:
  5071.         type: array
  5072.         items:
  5073.           $ref: '#/definitions/Artist-details'
  5074.       mainArtist:
  5075.         type: array
  5076.         items:
  5077.           $ref: '#/definitions/mainArtist-details'
  5078.       code:
  5079.         type: string
  5080.         description: код для того чтобы поделиться треком с другом
  5081.       available:
  5082.         type: boolean
  5083.         description: указывает доступен ли трек для проигрывания для данного пользователя ture\false
  5084.       publish_date:
  5085.         type: integer
  5086.         format: int32
  5087.         description: дата с какого числа должен трек быть доступен в системе. Если это премьера правообладатель может захотеть чтобы дата была в будущем
  5088.       genre:
  5089.         type: array
  5090.         items:
  5091.           $ref: '#/definitions/Genre-details'
  5092.       albums:
  5093.         type: array
  5094.         items:
  5095.           $ref: '#/definitions/Album-details'
  5096.       regions:
  5097.         type: array
  5098.         items:
  5099.           $ref: '#/definitions/Regions-details'    
  5100.        
  5101.   Playlist-copy-details:
  5102.     type: object
  5103.     properties:
  5104.       id:
  5105.         type: string
  5106.         description: уникальный id плейлиста
  5107.       name:
  5108.         type: string
  5109.         description: название Плейлиста
  5110.       type:
  5111.         type: integer
  5112.         format: int32
  5113.         description: код, для данного контента (тип 1 - пользовательский плейлист; тип 2 - альбом; тип 3 - сборник; тип 4 - системный плейлист; тип 5 - сингл)
  5114.       status:
  5115.         type: integer
  5116.         format: int32
  5117.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5118.       songs_count:
  5119.         type: integer
  5120.         format: int32
  5121.         description: количество треков у данного плейлиста
  5122.       description:
  5123.         type: string
  5124.         description: ХЗ (возможно тут должно быть описание плейлиста)
  5125.       duration:
  5126.         type: integer
  5127.         format: int32
  5128.         description: продолжительность данного плейлиста
  5129.       user_id:
  5130.         type: string
  5131.         description: уникальный ID пользователя, который создал данный объект
  5132.       released_at:
  5133.         type: integer
  5134.         format: int32
  5135.         description: дата релиза данного плейлиста
  5136.       created_at:
  5137.         type: integer
  5138.         format: int32
  5139.         description: дата создания данного плейлиста
  5140.       visible:
  5141.         type: integer
  5142.         format: int32
  5143.         description: 1 - отображать, 0 - не отображать
  5144.       likes:
  5145.         type: integer
  5146.         format: int32
  5147.         description: количество лайков у плейлиста
  5148.       cover:
  5149.         type: string
  5150.         description: линк на кавер Плейлиста
  5151.       cover_id:
  5152.         type: string
  5153.         description: уникальный ID кавера у плейлиста
  5154.       code:
  5155.         type: string
  5156.         description: шорт код для share
  5157.  
  5158. #  Add-related-artists:
  5159. #    type: object
  5160. #    properties:
  5161. #      artists:
  5162. #        type: string
  5163. #        description: имя исполнителя, которого мы добавляем к основному исполнителю, как ПОХОЖЕГО
  5164. #        default: "096eb4d1-8b44-28f4-7df1-70fdadcaf6a4"
  5165.  
  5166.   Artist-edited-profile:
  5167.     type: object
  5168.     properties:
  5169.       id:
  5170.         type: string
  5171.         description: уникальный id исполнителя
  5172.         default: "9656b1d4-3153-8cc4-5367-72837a030c2b"
  5173.       name:
  5174.         type: string
  5175.         description: имя исполнителя
  5176.         default: Давронио
  5177.       status:
  5178.         type: integer
  5179.         format: int32
  5180.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5181.       playlist_count:
  5182.         type: integer
  5183.         format: int32
  5184.         description: количество плейлистов у данного исполнителя
  5185.       songs_count:
  5186.         type: integer
  5187.         format: int32
  5188.         description: количество песен у данного исполнителя
  5189.       biography:
  5190.         type: string
  5191.         description: биография данного исполнителя
  5192.         default: биография артиста Давронио
  5193.        
  5194.        
  5195.       cover:
  5196.         type: string
  5197.         description: линк на кавер исполнителя
  5198.         default: "http://devdl.lamuz.uz/artist/image/e0ec67df-98aa-8381-12d7-fde681ff8fcc.jpg?ts=99ec520125ccd3320b7bb0d3be03cfef"
  5199.       cover_id:
  5200.         type: string
  5201.         description: уникальтый id исполнителя (хз что это)
  5202.         default: "e0ec67df-98aa-8381-12d7-fde681ff8fcc"
  5203.       likes:
  5204.         type: integer
  5205.         format: int32
  5206.         description: количество пользователей, отметивших лайком исполнителя
  5207.       created_at:
  5208.         type: integer
  5209.         format: int32
  5210.         description: дата создания исполнителя
  5211.       updated_at:
  5212.         type: string
  5213.         format: date-time
  5214.         description: дата обновления записей об исполнителе
  5215.       available:
  5216.         type: string
  5217.         description: хз что это значит
  5218.       code:
  5219.         type: string
  5220.         description: шорт код для share
  5221.         default: "nJOmlFZ8"
  5222.        
  5223.   Playlist-rotation-model:
  5224.     type: string
  5225.     properties:
  5226.       song1:
  5227.         type: string
  5228.         description: позиция первого трека
  5229.         default: "2dbb6d71-305b-2d0e-17df-db14d9217f4c: 5"
  5230.       song2:
  5231.         type: string
  5232.         description: позиция второго трека
  5233.         default: "3cae0c07-81ef-a6ac-f759-7ff2fbeb5ef7: 9"
  5234.       song3:
  5235.         type: string
  5236.         description: позиция третьего трека
  5237.         default: "3f0159be-9030-c3c8-96f3-c84892a616ad: 15"
  5238.        
  5239.   Like-for-artist:
  5240.     type: string
  5241.     properties:
  5242.       like:
  5243.         type: string
  5244.         description: пустая модель
  5245.    
  5246.   Created-Artist-details:
  5247.     type: object
  5248.     properties:
  5249.       id:
  5250.         type: string
  5251.         description: уникальный id исполнителя
  5252.         default: "9fa5d8dc-cfe6-0410-6b52-874d6e38568c"
  5253.       name:
  5254.         type: string
  5255.         description: имя исполнителя
  5256.         default: Swagger Test
  5257.       status:
  5258.         type: integer
  5259.         format: int32
  5260.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5261.       playlist_count:
  5262.         type: integer
  5263.         format: int32
  5264.         description: количество плейлистов у данного исполнителя
  5265.       songs_count:
  5266.         type: integer
  5267.         format: int32
  5268.         description: количество песен у данного исполнителя
  5269.       biography:
  5270.         type: string
  5271.         description: биография данного исполнителя
  5272.       cover:
  5273.         type: string
  5274.         description: линк на кавер исполнителя
  5275.         default: "http://devdl.lamuz.uz/artist/image/d7ae9b33-632e-e640-d917-33314bdc153c.jpg?ts=aa5309deeff2d86dfe3127675dbf30ff"
  5276.       cover_id:
  5277.         type: string
  5278.         description: уникальтый id исполнителя (хз что это)
  5279.         default: "d7ae9b33-632e-e640-d917-33314bdc153c"
  5280.       likes:
  5281.         type: integer
  5282.         format: int32
  5283.         description: количество пользователей, отметивших лайком исполнителя
  5284.       created_at:
  5285.         type: integer
  5286.         format: int32
  5287.         description: дата создания исполнителя
  5288.       updated_at:
  5289.         type: integer
  5290.         format: int32
  5291.         description: дата обновления записей об исполнителе
  5292.       available:
  5293.         type: string
  5294.         description: хз что это значит
  5295.       code:
  5296.         type: string
  5297.         description: шорт код для share
  5298.         default: "nakBSOrj"
  5299.  
  5300. #         ===================== SYNC MODELS ========================  
  5301.   Sync-History-Item:
  5302.     type: object
  5303.     properties:
  5304.       actionTime:
  5305.         type: string
  5306.         description: Время добавления сущности, которой добавляем лайк (трек, артист, плейлист/альбом)
  5307.       entityId:
  5308.         type: string
  5309.         description: уникальный id сущности, которой добавляем лайк (трек, артист, плейлист/альбом)
  5310.       status:
  5311.         type: string
  5312.         default: "0"
  5313.         description: "Статус для сущности (трек, артист, плейлист/альбом) (1 - лайк / 0 - дизлайк)"
  5314.  
  5315.   Sync-Track-Model:
  5316.     type: object
  5317.     properties:
  5318.       history:
  5319.         type: array
  5320.         items:
  5321.           $ref: "#/definitions/Sync-History-Item"
  5322.       lastSync:
  5323.         type: string
  5324.         description: Время последней синхронизации
  5325.         default: "2017-03-03T12:21:45+05:00"
  5326.  
  5327.   Sync-Artist-Model:
  5328.     type: object
  5329.     properties:
  5330.       history:
  5331.         type: array
  5332.         items:
  5333.           $ref: "#/definitions/Sync-History-Item"
  5334.       lastSync:
  5335.         type: string
  5336.         description: Время последней синхронизации
  5337.         default: "2017-03-03T12:21:45+05:00"        
  5338.          
  5339.   Sync-Playlist-Model:
  5340.     type: object
  5341.     properties:
  5342.       history:
  5343.         type: array
  5344.         items:
  5345.           $ref: "#/definitions/Sync-History-Item"
  5346.       lastSync:
  5347.         type: string
  5348.         description: Время последней синхронизации
  5349.         default: "2017-03-03T12:21:45+05:00"        
  5350.  
  5351. #         ==================  SYNC ANSWER MODEL  ==================  
  5352.   Sync-like-Track-details:
  5353.     type: object
  5354.     properties:
  5355.       id:
  5356.         type: string
  5357.         description: уникальный номер трека в системе
  5358.       title:
  5359.         type: string
  5360.         description: название трека
  5361.       duration:
  5362.         type: integer
  5363.         format: int32
  5364.         description: длина произведения в секундах
  5365.       listen:
  5366.         type: integer
  5367.         format: int32
  5368.         description: количество прослушиваний
  5369.       status:
  5370.         type: integer
  5371.         format: int32
  5372.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5373.       language:
  5374.         type: string
  5375.         description: язык на котором спета песня
  5376.       year:
  5377.         type: integer
  5378.         format: int32
  5379.         description: год выпуска трека, например 2000 (четыре цифры)
  5380.       url:
  5381.         type: string
  5382.         description: сайт откуда взят трек
  5383.       composer:
  5384.         type: string
  5385.         description: кто является композитором, если это классическая музыка.
  5386.       publisher_id:
  5387.         type: string
  5388.         description: уникальный номер правообладаетля в системе
  5389.       country:
  5390.         type: string
  5391.         description: страна где был выпущен этот трек
  5392.       censorship:
  5393.         type: boolean
  5394.         description: если есть мат то пишем true
  5395.       original_artist:
  5396.         type: string
  5397.         description: оригинальный исполнитель трека, если трек является кавером
  5398.       created_at:
  5399.         type: string
  5400.         description: дата загрузки трека в систему
  5401.       updated_at:
  5402.         type: string
  5403.         description: дата, когда были обновлены данные в треке
  5404.       representation:
  5405.         type: string
  5406.         description: линк для ядра(плеер) в виде JSON где есть инфо о видах репрезентации (качеств трека)
  5407.       cover:
  5408.         type: string
  5409.         description: линк на картину трека\альбома. Иногда называется кавер
  5410.       cover_id:
  5411.         type: string
  5412.         description: Айдишка трека, точно незнаю что это
  5413.       likes:
  5414.         type: integer
  5415.         format: int32
  5416.         description: количество нажатых лайков
  5417.       artists:
  5418.         type: array
  5419.         items:
  5420.           $ref: '#/definitions/Artist-details'
  5421.       mainArtist:
  5422.         type: array
  5423.         items:
  5424.           $ref: '#/definitions/mainArtist-details'
  5425.       code:
  5426.         type: string
  5427.         description: код для того чтобы поделиться треком с другом
  5428.       available:
  5429.         type: boolean
  5430.         description: указывает доступен ли трек для проигрывания для данного пользователя ture\false
  5431.       publish_date:
  5432.         type: integer
  5433.         format: int32
  5434.         description: дата с какого числа должен трек быть доступен в системе. Если это премьера правообладатель может захотеть чтобы дата была в будущем
  5435.       likeStatus:
  5436.         type: integer
  5437.         format: int32
  5438.         description: Статус лайка (после лайка -1; после дизлайка -0)
  5439.       actionTime:
  5440.         type: string
  5441.         format: date
  5442.         description: Время последних действий с данным объектом
  5443.  
  5444.   Sync-like-Artist-details:
  5445.     type: object
  5446.     properties:
  5447.       id:
  5448.         type: string
  5449.         description: уникальный id исполнителя
  5450.       name:
  5451.         type: string
  5452.         description: имя исполнителя
  5453.       status:
  5454.         type: integer
  5455.         format: int32
  5456.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5457.       playlist_count:
  5458.         type: integer
  5459.         format: int32
  5460.         description: количество плейлистов у данного исполнителя
  5461.       songs_count:
  5462.         type: integer
  5463.         format: int32
  5464.         description: количество песен у данного исполнителя
  5465.       biography:
  5466.         type: string
  5467.         description: биография данного исполнителя
  5468.       cover:
  5469.         type: string
  5470.         description: линк на кавер исполнителя
  5471.       cover_id:
  5472.         type: string
  5473.         description: уникальтый id кавера исполнителя
  5474.       likes:
  5475.         type: integer
  5476.         format: int32
  5477.         description: количество пользователей, отметивших лайком исполнителя
  5478.       created_at:
  5479.         type: integer
  5480.         format: int32
  5481.         description: дата создания исполнителя
  5482.       updated_at:
  5483.         type: string
  5484.         format: date
  5485.         description: дата обновления записей об исполнителе
  5486.       available:
  5487.         type: string
  5488.         description: хз что это значит
  5489.       code:
  5490.         type: string
  5491.         description: шорт код для share
  5492.       likeStatus:
  5493.         type: integer
  5494.         format: int32
  5495.         description: Статус лайка (после лайка -1; после дизлайка -0)
  5496.       actionTime:
  5497.         type: string
  5498.         format: date
  5499.         description: Время последних действий с данным объектом
  5500.      
  5501.   Sync-like-Playlist-details:
  5502.     type: object
  5503.     properties:
  5504.       id:
  5505.         type: string
  5506.         description: уникальный id плейлиста
  5507.       name:
  5508.         type: string
  5509.         description: название Плейлиста
  5510.       type:
  5511.         type: integer
  5512.         format: int32
  5513.         description: код, для данного контента (тип 1 - пользовательский плейлист; тип 2 - альбом; тип 3 - сборник; тип 4 - системный плейлист; тип 5 - сингл)
  5514.       status:
  5515.         type: integer
  5516.         format: int32
  5517.         description: "Статус у данного элемента STATUS_ON_MODERATION = 0; STATUS_ACTIVE = 1; STATUS_DELETED = 2;"
  5518.       songs_count:
  5519.         type: integer
  5520.         format: int32
  5521.         description: количество треков у данного плейлиста
  5522.       description:
  5523.         type: string
  5524.         description: ХЗ (возможно тут должно быть описание плейлиста)
  5525.       duration:
  5526.         type: integer
  5527.         format: int32
  5528.         description: общая длительность данного плейлиста
  5529.       user_id:
  5530.         type: string
  5531.         description: уникальный ID пользователя, который создал данный объект
  5532.       released_at:
  5533.         type: integer
  5534.         format: int32
  5535.         description: дата релиза данного плейлиста
  5536.       created_at:
  5537.         type: integer
  5538.         format: int32
  5539.         description: дата создания данного плейлиста
  5540.       visible:
  5541.         type: integer
  5542.         format: int32
  5543.         description: 1 - отображать, 0 - не отображать
  5544.       likes:
  5545.         type: integer
  5546.         format: int32
  5547.         description: количество лайков у плейлиста
  5548.       cover:
  5549.         type: string
  5550.         description: линк на кавер Плейлиста
  5551.       cover_id:
  5552.         type: string
  5553.         description: уникальный ID кавера у плейлиста
  5554.       code:
  5555.         type: string
  5556.         description: шорт код для share
  5557.       category:
  5558.         type: array
  5559.         items:
  5560.           $ref: '#/definitions/Category-details'
  5561.       position:
  5562.         type: integer
  5563.         format: int32
  5564.         description: Позиция плейлиста в Категории
  5565.       likeStatus:
  5566.         type: integer
  5567.         format: int32
  5568.         description: Статус лайка (после лайка -1; после дизлайка -0)
  5569.       actionTime:
  5570.         type: string
  5571.         format: date
  5572.         description: Время последних действий с данным объектом
  5573.  
  5574. #         ==================  RELATED ARTIST MODEL  ==================  
  5575.      
  5576.   Related-Artist-Model:
  5577.     type: object
  5578.     properties:
  5579.       artists[]:
  5580.         type: array
  5581.         items:
  5582.           $ref: "#/definitions/Artist[]-Model"
  5583.  
  5584.   Artist[]-Model:
  5585.     type: string
  5586.     description: Уникальный id артиста, которого мы добавляем в раздел ПОХОЖИЕ
  5587.        
  5588.          
  5589. ################################################################################
  5590. #                                   Errors                                     #
  5591. ################################################################################  
  5592.   Error-message:
  5593.     type: object
  5594.     properties:
  5595.       field:
  5596.         type: string
  5597.         description: название поля модели или заголовка которые не были заполнены или заполнены не верно
  5598.       message:
  5599.         type: array
  5600.         items:
  5601.           type: string
  5602.  
  5603.   Error-response:
  5604.    type: object
  5605.    properties:
  5606.     name:
  5607.       type: string
  5608.     message:
  5609.       type: string
  5610.     code:
  5611.       type: integer
  5612.       format: int32
  5613.     status:
  5614.       type: integer
  5615.       format: int32
  5616.     errors:
  5617.       type: array
  5618.       items:
  5619.         $ref: "#/definitions/Error-message"
  5620.     version:
  5621.       type: string
  5622.  
  5623. ################################################################################
  5624. #                             securityDefinitions                              #
  5625. ################################################################################
  5626. securityDefinitions:
  5627.   Bearer:
  5628.     description: |
  5629.      Для получения доступа к API необходимо указать действительный JWT token,
  5630.       передавая его в заголовок 'Authorization' при каждом запросе к серверу.
  5631.      
  5632.      
  5633.       Чтобы получить JWT token необходимо воспользоваться одним из запросов
  5634.         * `/users/me`
  5635.         * `/users/signin`
  5636.         * `/users/social`
  5637.  
  5638.       Токен в заголовке 'Authorization' должен передаваться таким образом:
  5639.      
  5640.       `Bearer XXXXXXXXXXXXXXXX`
  5641.          
  5642.     type: apiKey
  5643.     name: Authorization
  5644.     in: header
  5645.     #template: "Bearer {apiKey}"
  5646.  
  5647. ################################################################################
  5648. #                                   Parameters                                 #
  5649. ################################################################################
  5650. parameters:
  5651.   X-Make:
  5652.     name: X-Make
  5653.     in: header
  5654.     description: Версия платформы устройства
  5655.     required: true
  5656.     type: string
  5657.     default: Xiaomi
  5658.   X-Model:
  5659.     name: X-Model
  5660.     in: header
  5661.     description: Модель устройства
  5662.     required: true
  5663.     type: string
  5664.     default: Redmi 4
  5665.   X-Platform:
  5666.     name: X-Platform
  5667.     in: header
  5668.     description: Платформа (iOS, Android, WEB)
  5669.     required: true
  5670.     type: string
  5671.     default: android
  5672.   X-Platform-Version:
  5673.     name: X-Platform-Version
  5674.     in: header
  5675.     description: Версия платформы устройства
  5676.     required: true
  5677.     type: string
  5678.     default: 6.0.1
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement
Public Pastes
Advertisement
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!