GET /musebase/playlists/{playlist_id}

Returns PlaylistModel.

Request URL params:

playlist_id: int

Request headers:

token: string

Response:

{
   ID: int,
   Name: string,
   Release: string,
   Description: string,
   Tracks: list[int],
   Author: ShortUserModel,
   Timestamp: int,
   Cover: int
}

More about ShortUserModel you can look here: /user/{user_id}

Example:

{
   ID: 68,
   Name: "alone... again",
   Release: "2022",
   Description: "",
   Tracks: [
      4971,
      4972,
      4973
      4974,
      4976
   ],
   Author: {
      ID: 1,
      Name: "Ілля",
      Surname: "Чернов",
      Link: "sample",
      Avatar: 715,
      Sub: 1,
      Verify: "Default",
      Ban: 0,
      Emoji: ":ua:",
      CosmeticAvatar: 0
   },
   Timestamp: 1695016301,
   Cover: 676
}

Errors:

auth_failed: token authorization failed

invalid_tracks: failed to read tracks json

Legacy

Legacy endpoint allows you to display a PlaylistLegacyModel that contains a TrackModel instead of a track ID.

GET /musebase/playlists/{playlist_id}/legacy

Returns PlaylistLegacyModel.

Request URL params:

playlist_id: int

Response:

{
   ID: int,
   Name: string,
   Release: string,
   Description: string,
   Tracks: list[TrackModel],
   Author: ShortUserModel,
   Timestamp: int,
   Cover: int
}

Example:

{
   ID: 68,
   Name: "alone... again",
   Release: "2022",
   Description: "",
   Tracks: [
        {
            ID: 4971,
            Name: "chamber of reflection",
            Author: "mac demarco",
            Mine: false,
            Release: "2014",
            Size: "9.29",
            Duration: 232,
            Timestamp: 1678665089,
            Cover: 538,
            Url: "https://cdn.yurba.one/musebase/4971.mp3"
        },
        {
            ID: 4972,
            Name: "No Suprises",
            Author: "Radiohead",
            Mine: false,
            Release: "1997",
            Size: "5.69",
            Duration: 229,
            Timestamp: 1678665151,
            Cover: 0,
            Url: "https://cdn.yurba.one/musebase/4972.mp3"
        },
        {
            ID: 4973,
            Name: "K",
            Author: "Cigarettes After Sex",
            Mine: false,
            Release: "2017",
            Size: "12.79",
            Duration: 320,
            Timestamp: 1678665297,
            Cover: 539,
            Url: "https://cdn.yurba.one/musebase/4973.mp3"
        },
        {
            ID: 4974,
            Name: "Space Song",
            Author: "Beach House",
            Mine: false,
            Release: "2015",
            Size: "12.84",
            Duration: 321,
            Timestamp: 1678665393,
            Cover: 540,
            Url: "https://cdn.yurba.one/musebase/4974.mp3"
        },
        {
            ID: 4976,
            Name: "welcome and goodbye ",
            Author: "dream, ivory",
            Mine: false,
            Release: "2018",
            Size: "3.33",
            Duration: 120,
            Timestamp: 1678668421,
            Cover: 542,
            Url: "https://cdn.yurba.one/musebase/4976.mp3"
        }
   ],
   Author: {
      ID: 1,
      Name: "Ілля",
      Surname: "Чернов",
      Link: "sample",
      Avatar: 715,
      Sub: 1,
      Verify: "Default",
      Ban: 0,
      Emoji: ":ua:",
      CosmeticAvatar: 0
   },
   Timestamp: 1695016301,
   Cover: 676
}