Buy LSR Styng

Sections

Theme switcher

STYNGR API

STYNGR API can be used to play licensed music inside of your application by creating many different playlists that end users can choose from, offering radio-like experience by allowing users to choose playlist which suits their taste. Songs are randomly chosen from selected playlist and if end user does not like a certain song, they have an option to skip a song, up to 6 times within one hour period.

Our API endpoints are secured with two kind of JWT tokens with different scopes, which are issued to each end user separately.

Was this section helpful?

What made this section unhelpful for you?

Base URL

Production:

https://api.styngr.com

Staging:

https://stg.api.styngr.com

Language Box

Was this section helpful?

What made this section unhelpful for you?

Authentication

Was this section helpful?

What made this section unhelpful for you?

Styngs

Styngs are in-game emotes followed by up to 30 seconds long song clips. Users can buy styng which they can bind to an application event. Once the application user triggers an application event, styng can be reproduced, so that nearby players can hear their styng. Styngs can also be preloaded during loading of game session, by pulling binded styngs of each user in that game session.

Application Errors

Allow game developers to send errors messages they have encountered

User Event Tracking

Application Tests

Application Events

Application events are in-game events to which users can bind their Styngs. Example of application events would be a headshot, scored goal or player spawning at the base.

Notifications

Notification APIs for application end user.

Payment Transactions

Payment transactions are created for every product purchase, e.g. Styng, Stynglist or Radio Subscription, with external payment system handling the actual payment processing. Applications that implement Styngr API must use the payment confirmation API in order for user to obtain access to their bought product.

Promo messages

Radio Subscriptions

Radio subscriptions allow user to listen to your application's playlist, without Ads. At the moment, user can choose between following subscription types: Monthly, Stream-count based, or Playback-time based. Monthly subscriptions, as their name suggests, allow users to have an unlimited radio listening experience for thirty days after their subscription purchase. Monthly subscriptions can be renewed at any point in time, while they are in active or pending payment state. Stream-count subscriptions offer a limited number of tracks which users can listen to. Every single request that returns a random track is counted towards this quota. Once the quota is spent, users will have to purchase a new subscription, or they will be back on Ad-funded listening experience if it's available in your application. Playback-time based subscriptions offer a limited number of minutes to which users can listen to. Once the quota is spent, users will have to purchase a new subscription, or they will be back on Ad-funded listening experience.

SDK Users

APIs related to application end users, which allows operations such as in-game currency balance update and addition of Styngs/Stynglists as rewards to users.

Soundboards

Soundboards are collection of chosen styngs for your application that application users can subscribe to and use during their game session. Application can have multiple soundboards but only one published soundboard per source.

Stynglists

Stynglists are collection of Styngs which allows user to buy multiple Styngs more easily.

LSR styngs

LSR styngs are in-game emotes followed by up to 30 seconds long song clips. Users can buy LSR styngs which they can bind to an application event. Once the application user triggers an application event, LSR styngs can be reproduced, so that nearby players can hear their LSR styng. LSR styngs can also be preloaded during loading of game session, by pulling binded LSR styngs of each user in that game session.

Was this section helpful?

What made this section unhelpful for you?

Get LSR Styng Info

Get information about specific LSR Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
LSR Styng information.

Response Attributes

albumstring
artiststring
availabilityarray Required
Enum values:
AFAXALDZASADAOAIAQAG
... 239 other enums
Allow unique items
true

Show child attributes

currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found or LSR Styng is not found/not available in user's country.

Response Attributes

albumstring
artiststring
availabilityarray Required
Enum values:
AFAXALDZASADAOAIAQAG
... 239 other enums
Allow unique items
true

Show child attributes

currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
200
Object
LSR Styng information.

Response Attributes

albumstring
artiststring
currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found or LSR Styng is not found/not available in user's country.

Response Attributes

albumstring
artiststring
currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/lsr/{styngId}

Select
1 2 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}' \ --header 'Authorization: Bearer {token}' \

Response

LSR Styng information.
Was this section helpful?

What made this section unhelpful for you?

Download LSR Styng

Download a LSR Styng with provided UUID.

Header Parameters

Authorizationstring

Query Parameters

ownerIdstring Required

User ID that owns this LSR Styng.

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
Redirection to LSR Styng public URL.

Response Attributes

applicationContextobject

Show child attributes

attributesMapobject
beanNamestring
contentTypestring
exposePathVariablesboolean
hostsarray

Show child attributes

propagateQueryPropertiesboolean
redirectViewboolean
requestContextAttributestring
staticAttributesobject
urlstring
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
LSR Styng with provided UUID does not exist or it is not available in user's country.

Response Attributes

applicationContextobject

Show child attributes

attributesMapobject
beanNamestring
contentTypestring
exposePathVariablesboolean
hostsarray

Show child attributes

propagateQueryPropertiesboolean
redirectViewboolean
requestContextAttributestring
staticAttributesobject
urlstring
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/lsr/{styngId}/download?ownerId=

Select
1 2 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/download?ownerId=' \ --header 'Authorization: Bearer {token}'

Response

Redirection to LSR Styng public URL.
Was this section helpful?

What made this section unhelpful for you?

Play LSR Styng preview

Create a LSR Styng preview URL. LSR Styng owner can create as many preview links as they want, while other users can create only one URL. Users that do not own the Styng they are previewing will be allowed to create one Styng preview URL per minute per Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
LSR Styng URL for preview play.

Response Attributes

expiresAtstring (date-time)Required
urlstring (url)Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
LSR Styng Preview Link already created for this user.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

expiresAtstring (date-time)Required
urlstring (url)Required
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/{styngId}/play

Select
1 2 curl --location --globoff --request POST 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/play' \ --header 'Authorization: Bearer {token}'

Response

LSR Styng URL for preview play.
Was this section helpful?

What made this section unhelpful for you?

Save LSR Styng Played event

Save information who played which LSR Styng, from which app and device and from which country.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Body Parameters

ownerIdstring Required

ID of Styng owner.

Response

200
Object
Response does not contain a body.
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/{styngId}/played

Select
1 2 3 4 5 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/played' \ --header 'Authorization: Bearer {token}' \ --data '{ "ownerId": "" }'

Response

Response does not contain a body.
Was this section helpful?

What made this section unhelpful for you?

Get current user LSR Styngs

Get all distinct user's LSR Styngs, including LSR Styngs from bought StyngLists.

Header Parameters

Authorizationstring

Query Parameters

useRedirectUrlboolean

Boolean flag that indicates if LSR Styng image URLs should use redirect URLs pointing to their asset.

Response

200
Object
Users LSR Styngs

Response Attributes

styngsarray Required

Show child attributes

401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

styngsarray Required

Show child attributes

200
Object
Users LSR Styngs

Response Attributes

styngsarray Required

Show child attributes

401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

styngsarray Required

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/lsr/my?useRedirectUrl=

Select
1 2 curl --location 'https://api.styngr.com/api/v1/sdk/styngs/lsr/my' \ --header 'Authorization: Bearer {token}' \

Response

Users LSR Styngs
Was this section helpful?

What made this section unhelpful for you?

Bind LSR Styng

Bind provided LSR Styng to App Event for given user.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Body Parameters

eventIdstring (uuid)Required

UUID of App Event to which Styng or Nft should be bound.

Response

200
Object
Information about successfully created binding.

Response Attributes

appEventShortInfoobject Required

Show child attributes

styngobject Required

Show child attributes

userobject Required

Show child attributes

401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Indicates that user or app event does not exist. It can also indicate that the user does not own a LSR Styng with the provided ID.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/{styngId}/bind

Select
1 2 3 4 5 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/bind' \ --header 'Authorization: Bearer {token}' \ --data '{ "eventId": "be84ffeb-c1fb-439a-8b73-4d45710af508" }'

Response

Information about successfully created binding.
Was this section helpful?

What made this section unhelpful for you?

Buy LSR Styng

Place a transaction for user that buys a LSR Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
Information about created transaction along with external Payment System URL.

Response Attributes

paymentUrlstring
pricenumber Required
productNamestring Required
transactionIdstring (uuid)Required
userIdstring Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/{styngId}/buy

Select
1 2 curl --location --globoff --request POST 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/buy' \ --header 'Authorization: Bearer {token}'

Response

Information about created transaction along with external Payment System URL.
Was this section helpful?

What made this section unhelpful for you?

Save LSR Styng Played event

Save information who played which LSR Styng, from which app and device and from which country.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Body Parameters

ownerIdstring Required

ID of Styng owner.

Response

200
Object
Response does not contain a body.
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/{styngId}/played

Select
1 2 3 4 5 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/lsr/{styngId}/played' \ --header 'Authorization: Bearer {token}' \ --data '{ "ownerId": "" }'

Response

Response does not contain a body.
Was this section helpful?

What made this section unhelpful for you?

Get LSR styngs

Get information about active LSR Styngs in application with ID provided via User JWT.

Header Parameters

Authorizationstring

Query Parameters

namestring

LSR Styng name. (Optional)

sizeinteger (int32)Required

Number of LSR Styngs returned in response.

pageinteger (int32)Required

Index of requested page.

useRedirectUrlboolean

Boolean flag that indicates if LSR Styng image URLs should use redirect URLs pointing to their asset.

Response

200
Object
Paginated response with information about LSR Styngs in Application.

Response Attributes

itemsarray Required

Show child attributes

itemsCountinteger (int32)Required
pagesCountinteger (int32)Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
200
Object
Paginated response with information about LSR Styngs in Application.

Response Attributes

itemsarray Required

Show child attributes

itemsCountinteger (int32)Required
pagesCountinteger (int32)Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs?name=&size=&page=&useRedirectUrl=

Select
1 2 curl --location 'https://api.styngr.com/api/v1/sdk/styngs?size=&page=' \ --header 'Authorization: Bearer {token}' \

Response

Paginated response with information about LSR Styngs in Application.
Was this section helpful?

What made this section unhelpful for you?

Get LSR styngs

Get information about active LSR Styngs in application with ID provided via User JWT.

Header Parameters

Authorizationstring

Query Parameters

namestring

LSR Styng name. (Optional)

sizeinteger (int32)Required

Number of LSR Styngs returned in response.

pageinteger (int32)Required

Index of requested page.

useRedirectUrlboolean

Boolean flag that indicates if LSR Styng image URLs should use redirect URLs pointing to their asset.

Response

200
Object
Paginated response with information about LSR Styngs in Application.

Response Attributes

itemsarray Required

Show child attributes

itemsCountinteger (int32)Required
pagesCountinteger (int32)Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/lsr?name=&size=&page=&useRedirectUrl=

Select
1 2 curl --location 'https://api.styngr.com/api/v1/sdk/styngs/lsr?size=&page=' \ --header 'Authorization: Bearer {token}'

Response

Paginated response with information about LSR Styngs in Application.
Was this section helpful?

What made this section unhelpful for you?

Pull users LSR Styngs

Get LSR Styngs with their public URLs for every provided user ID.

Header Parameters

Authorizationstring

Query Parameters

noRedirectboolean

Indicates if LSR Styng URLs should be direct links or links for LSR Styng download API. Defaults to false which means that returned links are formatted LSR Styng Download API links.

Body Parameters

userIdsarray Required

Show child attributes

Response

200
Object
Array of LSR Styng objects with public URLs for download.

Response Attributes

bindingsarray Required

Show child attributes

userIdstring Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
200
Object
Array of LSR Styng objects with public URLs for download.

Response Attributes

bindingsarray Required

Show child attributes

userIdstring Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/lsr/pull?noRedirect=

Select
1 2 3 4 5 6 7 curl --location 'https://api.styngr.com/api/v1/sdk/styngs/lsr/pull' \ --header 'Authorization: Bearer {token}' \ --data '{ "userIds": [ "" ] }'

Response

Array of LSR Styng objects with public URLs for download.
Was this section helpful?

What made this section unhelpful for you?

Get current user LSR Styngs

Get all distinct user's LSR Styngs, including LSR Styngs from bought StyngLists.

Header Parameters

Authorizationstring

Query Parameters

useRedirectUrlboolean

Boolean flag that indicates if LSR Styng image URLs should use redirect URLs pointing to their asset.

Response

200
Object
Users LSR Styngs

Response Attributes

styngsarray Required

Show child attributes

401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

styngsarray Required

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/my?useRedirectUrl=

Select
1 2 curl --location 'https://api.styngr.com/api/v1/sdk/styngs/my' \ --header 'Authorization: Bearer {token}'

Response

Users LSR Styngs
Was this section helpful?

What made this section unhelpful for you?

Pull users LSR Styngs

Get LSR Styngs with their public URLs for every provided user ID.

Header Parameters

Authorizationstring

Query Parameters

noRedirectboolean

Indicates if LSR Styng URLs should be direct links or links for LSR Styng download API. Defaults to false which means that returned links are formatted LSR Styng Download API links.

Body Parameters

userIdsarray Required

Show child attributes

Response

200
Object
Array of LSR Styng objects with public URLs for download.

Response Attributes

bindingsarray Required

Show child attributes

userIdstring Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/pull?noRedirect=

Select
1 2 3 4 5 6 7 curl --location 'https://api.styngr.com/api/v1/sdk/styngs/pull' \ --header 'Authorization: Bearer {token}' \ --data '{ "userIds": [ "" ] }'

Response

Array of LSR Styng objects with public URLs for download.
Was this section helpful?

What made this section unhelpful for you?

Get LSR Styng Info

Get information about specific LSR Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
LSR Styng information.

Response Attributes

albumstring
artiststring
availabilityarray Required
Enum values:
AFAXALDZASADAOAIAQAG
... 239 other enums
Allow unique items
true

Show child attributes

currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found or LSR Styng is not found/not available in user's country.

Response Attributes

albumstring
artiststring
availabilityarray Required
Enum values:
AFAXALDZASADAOAIAQAG
... 239 other enums
Allow unique items
true

Show child attributes

currencyobject Required

Show child attributes

durationstring (duration)Required
externalMetadatastring
genresarray Required

Show child attributes

idstring (uuid)Required
imageobject Required

Show child attributes

isNewboolean Required
isPreviewAvailableboolean Required
namestring Required
pricenumber Required
statusstring Required
Enum values:
AVAILABLEPURCHASEDUNAVAILABLE
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/{styngId}

Select
1 2 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}' \ --header 'Authorization: Bearer {token}'

Response

LSR Styng information.
Was this section helpful?

What made this section unhelpful for you?

Bind LSR Styng

Bind provided LSR Styng to App Event for given user.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Body Parameters

eventIdstring (uuid)Required

UUID of App Event to which Styng or Nft should be bound.

Response

200
Object
Information about successfully created binding.

Response Attributes

appEventShortInfoobject Required

Show child attributes

styngobject Required

Show child attributes

userobject Required

Show child attributes

401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Indicates that user or app event does not exist. It can also indicate that the user does not own a LSR Styng with the provided ID.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/{styngId}/bind

Select
1 2 3 4 5 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}/bind' \ --header 'Authorization: Bearer {token}' \ --data '{ "eventId": "be84ffeb-c1fb-439a-8b73-4d45710af508" }'

Response

Information about successfully created binding.
Was this section helpful?

What made this section unhelpful for you?

Buy LSR Styng

Place a transaction for user that buys a LSR Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
Information about created transaction along with external Payment System URL.

Response Attributes

paymentUrlstring
pricenumber Required
productNamestring Required
transactionIdstring (uuid)Required
userIdstring Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/{styngId}/buy

Select
1 2 curl --location --globoff --request POST 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}/buy' \ --header 'Authorization: Bearer {token}'

Response

Information about created transaction along with external Payment System URL.
Was this section helpful?

What made this section unhelpful for you?

Download LSR Styng

Download a LSR Styng with provided UUID.

Header Parameters

Authorizationstring

Query Parameters

ownerIdstring Required

User ID that owns this LSR Styng.

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
Redirection to LSR Styng public URL.

Response Attributes

applicationContextobject

Show child attributes

attributesMapobject
beanNamestring
contentTypestring
exposePathVariablesboolean
hostsarray

Show child attributes

propagateQueryPropertiesboolean
redirectViewboolean
requestContextAttributestring
staticAttributesobject
urlstring
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
LSR Styng with provided UUID does not exist or it is not available in user's country.

Response Attributes

applicationContextobject

Show child attributes

attributesMapobject
beanNamestring
contentTypestring
exposePathVariablesboolean
hostsarray

Show child attributes

propagateQueryPropertiesboolean
redirectViewboolean
requestContextAttributestring
staticAttributesobject
urlstring
Was this section helpful?

What made this section unhelpful for you?

GET

/api/v1/sdk/styngs/{styngId}/download?ownerId=

Select
1 2 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}/download?ownerId=' \ --header 'Authorization: Bearer {token}'

Response

Redirection to LSR Styng public URL.
Was this section helpful?

What made this section unhelpful for you?

Play LSR Styng preview

Create a LSR Styng preview URL. LSR Styng owner can create as many preview links as they want, while other users can create only one URL. Users that do not own the Styng they are previewing will be allowed to create one Styng preview URL per minute per Styng.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Response

200
Object
LSR Styng URL for preview play.

Response Attributes

expiresAtstring (date-time)Required
urlstring (url)Required
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
LSR Styng Preview Link already created for this user.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
404
Object
Application user not found.

Response Attributes

expiresAtstring (date-time)Required
urlstring (url)Required
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/{styngId}/play

Select
1 2 curl --location --globoff --request POST 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}/play' \ --header 'Authorization: Bearer {token}'

Response

LSR Styng URL for preview play.
Was this section helpful?

What made this section unhelpful for you?

Save LSR Styng Played event

Save information who played which LSR Styng, from which app and device and from which country.

Header Parameters

Authorizationstring

Path Parameters

styngIdstring (uuid)Required

LSR Styng UUID.

Body Parameters

ownerIdstring Required

ID of Styng owner.

Response

200
Object
Response does not contain a body.
401
Object
Access token is not present or expired.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
403
Object
Access is forbidden.

Response Attributes

errorCodeinteger (int32)Required
errorMessagestring
Was this section helpful?

What made this section unhelpful for you?

POST

/api/v1/sdk/styngs/{styngId}/played

Select
1 2 3 4 5 curl --location --globoff 'https://api.styngr.com/api/v1/sdk/styngs/{styngId}/played' \ --header 'Authorization: Bearer {token}' \ --data '{ "ownerId": "" }'

Response

Response does not contain a body.
Was this section helpful?

What made this section unhelpful for you?

styng-statistics-controller

Spotify

Styngr integration with Spotify music platform.

Playlists V3

Royalty free playlists are set of songs that are linked to a single application, which allows users of that application to choose which music they will listen to during their game session. These songs are randomly selected from the playlist, and there is no skip limit for them.

Playlists V2

Playlists are set of songs that are linked to a single application, which allows users of that application to choose which music will they listen to during their game session. Users can skip through songs for up to 6 times during one hour period.

Playlists V2 - API Integration

Playlists are set of songs that are linked to a single application, which allows users of that application to choose which music will they listen to during their game session. Users can skip through songs for up to 6 times during one hour period.

Group sessions - API Integration

Styngr allows users to create a Group Sessions that will allow multiple users to listen to the same tracks at the same time. Group Session API is intended to be used with Playlist API, which means requesting tracks and submitting statistics needs to be performed as for Playlist Sessions for single users. Group Sessions can have two different user types: Owner and Members. Every user can belong only to single Group Session at the time. Every Group Session can have only one Group Session Owner, and multiple Group Session Members. Group Session Owner is responsible for media playback controls, that is, requesting a new track, skipping or pausing the current track. Group Session Members cannot impact listening flow, as they only have to synchronize with Group session Owner's actions. Synchronization between Owner and Members is currently left to implement to applications that are integrating with Styngr API.

Group sessions

Styngr allows users to create a Group Sessions that will allow multiple users to listen to the same tracks at the same time. Group Session API is intended to be used with Playlist API, which means requesting tracks and submitting statistics needs to be performed as for Playlist Sessions for single users. Group Sessions can have two different user types: Owner and Members. Every user can belong only to single Group Session at the time. Every Group Session can have only one Group Session Owner, and multiple Group Session Members. Group Session Owner is responsible for media playback controls, that is, requesting a new track, skipping or pausing the current track. Group Session Members cannot impact listening flow, as they only have to synchronize with Group session Owner's actions. Synchronization between Owner and Members is currently left to implement to applications that are integrating with Styngr API.

Statistics

Used for storing song and ad playback statistics.

Playlists

Playlists are set of songs that are linked to a single application, which allows users of that application to choose which music will they listen to during their game session. Users can skip through songs for up to 6 times during one hour period.

Playlists - API Integration

Playlists are set of songs that are linked to a single application, which allows users of that application to choose which music will they listen to during their game session. Users can skip through songs for up to 6 times during one hour period.

Applications

Styngr allows users to get basic information about applications they are using.

radio-info-controller

Roblox

Web3

Styngr SDK API

Styngr API can be used to play licensed music inside of your application by creating many different playlists that end users can choose from, offering radio-like experience by allowing users to choose playlist which suits their taste. Songs are randomly chosen from selected playlist and if end user does not like a certain song, they have an option to skip a song, up to 6 times within one hour period.
Our API endpoints are secured with two kind of JWT tokens with different scopes, which are issued to each end user separately.

Was this section helpful?

What made this section unhelpful for you?

Base URL

Production:

https://api.styngr.com

Staging:

https://stg.api.styngr.com

Language Box

Was this section helpful?

What made this section unhelpful for you?

roblox-campaign-controller

NFTs

Styngr offers an option to purchase an NFT inside of your application. NFTs are usually minted as a short audio snippet from our available pool of tracks. By purchasing an NFT, user will be able to use the NFT inside of your application, by playing an linked audio snippet. They also have an option to claim the NFT, which would transfer the ownership to their Ripple Ledger account. Styngr can at any time burn the NFT, if such need arises from legal perspective, upon request from record labels.

Xumm

Xumm platfrom is a non-custodial wallet that offers users to create/manage their Ripple Ledger accounts. Users can authenticate their wallets in our system through Xumm, which allows them to claim the already purchased NFTs to their Ripple Ledger account.

Radio Subscriptions - v2

Radio subscriptions allow user to listen to your application's playlist, without Ads. At the moment, user can choose between following subscription types: Monthly, Stream-count based, or Playback-time based. Monthly subscriptions, as their name suggests, allow users to have an unlimited radio listening experience for thirty days after their subscription purchase. Monthly subscriptions can be renewed at any point in time, while they are in active or pending payment state. Monthly subscriptions support multi-tier logic where playlists are divided into several tiers where each tier contains a specific combination of playlists which user is allowed to listen if he has a relevant subscription. Stream-count subscriptions offer a limited number of tracks which users can listen to. Every single request that returns a random track is counted towards this quota. Once the quota is spent, users will have to purchase a new subscription, or they will be back on Ad-funded listening experience if it's available in your application. Playback-time based subscriptions offer a limited number of minutes to which users can listen to. Once the quota is spent, users will have to purchase a new subscription, or they will be back on Ad-funded listening experience.