VL Group

Rhymba v3.6 Documentation

Account

The Account endpoints allow you to manage users. Get requests can be done anonymously, but post, put and delete operations require a user to be logged in, and in most cases, be associated with the playlist. The account endpoints will let you create those users, and log them in to receive an access token.

/Account/Register

POST

Javascript Example

var hash = CryptoJS.HmacSHA256('POST&/Account/Register/&password=correcthorsebatterystaple', private_key);
var hash64 = CryptoJS.enc.Base64.stringify(hash);

Header Name Type Description Example
system_access_token string Your Rhymba Access Token E32C8CFE8A1EC895C8C63FE5BD924941
system_access_secret string Your Rhymba Access Secret 25BA2FADE0B0F47A0D913EBBC8F1EB6C
hash string The request hash cndh6C/die66R+qwceUJW/dXBHYUwm6tVt8MhBayl/0=
Field Name Type Description Example
password string The user's password correcthorsebatterystaple

Returns

Type Description Example
integer New user's ID 27

/Account/Login

POST - Login uses HTTP basic authentication with User ID and Password base64 encoded. All values are in headers, no post body is required. Returns the Access Token you'll need for Playlist interactions. Access Token is valid for 60 minutes.

Javascript Example

var AuthHeader = 'Basic ' + btoa(id + ":" + pw);
var hash = CryptoJS.HmacSHA256('POST&/Account/Login/&', private_key);
var hash64 = CryptoJS.enc.Base64.stringify(hash);

Header Name Type Description Example
Authorization string The basic authentication header with the user and password base64 encoded. Basic dXNlcjpwYXNzd29yZA==
system_access_token string Your Rhymba Access Token E32C8CFE8A1EC895C8C63FE5BD924941
system_access_secret string Your Rhymba Access Secret 25BA2FADE0B0F47A0D913EBBC8F1EB6C
hash string The request hash cndh6C/die66R+qwceUJW/dXBHYUwm6tVt8MhBayl/0=

Returns

Type Description Example
string Access Token ZTMyYzhjZmU4YTFlYzg5NWM4YzYzZmU1YmQ5MjQ5NDE=
integer User Id 27
DateTime Expiration 2019-10-01T09:01:55.714942+00:00

/Account/Logout

POST

Header Name Type Description Example
system_access_token string Your Rhymba Access Token E32C8CFE8A1EC895C8C63FE5BD924941
system_access_secret string Your Rhymba Access Secret 25BA2FADE0B0F47A0D913EBBC8F1EB6C
hash string The request hash cndh6C/die66R+qwceUJW/dXBHYUwm6tVt8MhBayl/0=
Field Name Type Description Example
access_token string Access Token ZTMyYzhjZmU4YTFlYzg5NWM4YzYzZmU1YmQ5MjQ5NDE=

/Account/ChangePassword

POST

Header Name Type Description Example
system_access_token string Your Rhymba Access Token E32C8CFE8A1EC895C8C63FE5BD924941
system_access_secret string Your Rhymba Access Secret 25BA2FADE0B0F47A0D913EBBC8F1EB6C
hash string The request hash cndh6C/die66R+qwceUJW/dXBHYUwm6tVt8MhBayl/0=
Field Name Type Description Example
access_token string Access Token ZTMyYzhjZmU4YTFlYzg5NWM4YzYzZmU1YmQ5MjQ5NDE=
password string The new password 12345