Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AddSong ¶
AddSong godoc @Summary Добавление новой песни @Description Добавление новой песни с обогащением через внешний API. @Tags songs @Accept json @Produce json @Param song body models.Song true "Данные песни (обязательны поля group и song)" @Success 201 {object} map[string]int "ID добавленной песни" @Failure 400 {object} map[string]string @Failure 500 {object} map[string]string @Router /songs [post]
func DeleteSong ¶
DeleteSong godoc @Summary Удаление песни @Description Удаление песни по ID. @Tags songs @Accept json @Produce json @Param id path int true "ID песни" @Success 200 {object} map[string]string "Песня удалена" @Failure 400 {object} map[string]string @Failure 404 {object} map[string]string @Router /songs/{id} [delete]
func GetSongLyrics ¶
GetSongLyrics godoc @Summary Получение текста песни @Description Получение текста песни, разделённого на куплеты, с пагинацией. @Tags songs @Accept json @Produce json @Param id path int true "ID песни" @Param page query int false "Номер страницы" default(1) @Param limit query int false "Количество куплетов на страницу" default(1) @Success 200 {object} map[string]interface{} @Failure 400 {object} map[string]string @Failure 404 {object} map[string]string @Router /songs/{id}/lyrics [get]
func GetSongs ¶
GetSongs godoc @Summary Получение списка песен @Description Получение списка песен с фильтрацией по группе и названию, а также с пагинацией. @Tags songs @Accept json @Produce json @Param group query string false "Фильтр по группе" @Param song query string false "Фильтр по названию песни" @Param page query int false "Номер страницы" default(1) @Param limit query int false "Количество записей на странице" default(10) @Success 200 {array} models.Song @Failure 500 {object} map[string]string @Router /songs [get]
func UpdateSong ¶
UpdateSong godoc @Summary Обновление песни @Description Обновление данных песни по ID. @Tags songs @Accept json @Produce json @Param id path int true "ID песни" @Param song body models.Song true "Обновлённые данные песни" @Success 200 {object} map[string]string "Песня обновлена" @Failure 400 {object} map[string]string @Failure 500 {object} map[string]string @Router /songs/{id} [put]
Types ¶
This section is empty.