Yurba Docs
Yurba Documentation

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 /dialogs/messages/{message_id}

Returns DialogModel.

Request URL params:

message_id: int

Response:

{ ID: int, Author: ShortUserModel, Dialog: ShortDialogModel, Type: string, Text: string, Photos: []int, ReplyTo: MessageModel, Attachments: AttachmentModel, Timestamp: int, EditTimestamp: int, Read: bool } More about ShortUserModel you can look here: /user/{user_id}

About ShortDialogModel: /dialogs/{dialog_id}

About AttachmentModel: Scroll Down

Example:

{ ID: 56, Type: "channel", Members: 15, Author: { ID: 0, Name: "", Surname: "", Link: "", Avatar: 0, Sub: 0, Verify: "", Ban: 0, Emoji: "", CosmeticAvatar: 0, Online: { Online: false, LastBeen: 0, Degree: "" }, CommentsState: 0, ViewAvatarState: 0, RelationshipState: "" }, DialogDude: null, Name: "Yurba", Link: "yurba_news", Description: "Офіційний новинний канал Yurba", Avatar: 0, Verify: "Default", Private: false, LastMessage: { ID: 10788, Author: { ID: 0, Name: "", Surname: "", Link: "", Avatar: 0, Sub: 0, Verify: "", Ban: 0, Emoji: "", CosmeticAvatar: 0, Online: { Online: false, LastBeen: 0, Degree: "" }, CommentsState: 0, ViewAvatarState: 0, RelationshipState: "" }, Dialog: { ID: 56, Type: "channel", Name: "Yurba" }, Type: "message", Text: "", Photos: [-80, -82, -81, -83, -79], ReplyTo: null, Attachments: [], Timestamp: 1724114227, EditTimestamp: 0, Read: true }, Timestamp: 1713221679 }

Errors:

auth_failed: token authorization failed

invalid_photos: failed to read photos

invalid_attachments: failed to read attachments

AttachmentModel

{ ID: int, Type: string, # "track", "file" Track: TrackModel Timestamp: int } More about TrackModel you can look here: /musebase/{track_id}

Example:

{ ID: 24, Type: "track", Track: { ID: 5728, Name: "Yessirskiii", Author: "Clonnex", Mine: false, Release: "2024", Size: "1.84", Duration: 120, Timestamp: 1724706144, Cover: 1544, Url: "https://cdn.yurba.one/musebase/5728.mp3" }, Timestamp: 1724706212 }