Get started

Overview OAuth 2.0 Websocket API

Accounts

GET /get_me GET /tokens POST /login DELETE /logout POST /register POST /confirm POST /reset POST /reset_password GET /incoming_requests GET /outcoming_requests

Apps

GET /apps POST /apps GET /apps/{public_key} GET /apps/{public_key}/token POST /apps/{public_key}/token GET /apps/tokens DELETE /apps/tokens/{token} DELETE /apps/{app_id} GET /apps/user/{token}

Users

GET /user/{user_tag} GET /user/{user_tag}/friends GET /user/{user_tag}/playlists GET /user/{user_tag}/photos GET /user/{user_tag}/posts POST /user/{user_tag}/post

Relationships

GET /user/{user_tag}/relationships PATCH /user/{user_tag}/subscribe DELETE /incoming_requests/{user_id}

Dialogs (Messages)

GET /dialogs POST /dialogs POST /dialogs/private/{user_id} GET /dialogs/{dialog_id} GET /dialogs/{dialog_id}/messages GET /dialogs/messages/{message_id} DELETE /dialogs/messages/
{message_id}

Tracks (MuseBase)

GET /musebase/{track_id} GET /musebase/find/{mask} POST /musebase/upload GET /musebase/playlists/{playlist_id} GET /user/{user_tag}/playlists

Photos

GET /photos/{photo_id} POST /photos/upload DELETE /photos/{photo_id} GET /user/{user_tag}/photos

Posts

GET /posts/{post_id} DELETE /posts/{post_id} PATCH /posts/{post_id} PATCH /posts/{post_id}/like GET /posts/{post_id}/comments POST /posts/{post_id}/comment

Comments

GET /comments/{comment_id} DELETE /comments/{comment_id} PATCH /comments/{comment_id}/like

Safety

GET /safety/link

Other

GET /languages GET /countries GET /countries/{country_id}/regions GET /countries/{country_id}/regions/
{region_id}/cities

Yurba CDN (cdn.yurba.one)

GET /photos/{photo_id}.jpg GET /musebase/{track_id}.mp3

For Desktop Developers

START Get started METHOD Player METHOD CSS METHOD log METHOD select METHOD reload METHOD createWindow METHOD createNotification METHOD quit METHOD browse METHOD fetch METHOD unixToDate METHOD createButton METHOD eventButton METHOD setButtonIndicator METHOD hideButtonIndicator METHOD alert METHOD observe START Using Tab METHOD openTab METHOD closeTab METHOD setTab METHOD tabEvent OBJECT User OBJECT window

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
}