Simonc: Created page with "= Streaming Services = == TIDAL == Tidal's API is private. See Tidal for access to it. Or speak to us for help if you think that your access to the API would benefit OpenHome. ..."

2015-12-15T14:47:25Z

Created page with "= Streaming Services = == TIDAL == Tidal's API is private. See Tidal for access to it. Or speak to us for help if you think that your access to the API would benefit OpenHome. ..."

New page

= Streaming Services =

== TIDAL ==
Tidal's API is private. See Tidal for access to it. Or speak to us for help if you think that your access to the API would benefit OpenHome.

Assuming access to Tidal's API, the [[Av:Developer:Eriskay:CredentialsService | Credentials]] service can be used to retrieve the following information:
* The <tt>Ids</tt> property variable includes <tt>tidalhifi.com</tt> if Tidal is supported.
* <tt>Data</tt> from <tt>Get</tt> is JSON and contains at least the following fields:
<tt>
{
"country_code": "Tidal country code",
"user_id": "Tidal user identifier"
.....
}
</tt>
* <tt>Status</tt> from <tt>Get</tt> is blank if <tt>Username</tt> and <tt>Password</tt> are both either blank or set and valid. If <tt>Status</tt> is not blank, it contains either JSON returned from a Tidal API or an error string.
* The token returned from <tt>Login</tt> and <tt>Relogin</tt> is JSON and contains at least the following fields:
<tt>
{
"session_id": "Tidal session id"
.....
}
</tt>
* Tracks can be added to the [[Av:Developer:Eriskay:PlaylistService | Playlist]] service with urls in the form
<tt>
tidal://track?version=1&trackId=[tidal_track_id]
</tt>

== Qobuz ==
Qobuz's [https://github.com/Qobuz/api-documentation developer API] is published on github.

The [[Av:Developer:Eriskay:CredentialsService | Credentials]] service can be used to retrieve the following information:

* The <tt>Ids</tt> state variable includes <tt>qobuz.com</tt> if Qobuz is supported.
* <tt>Data</tt> from <tt>Get</tt> is JSON and contains at least the following fields:
<tt>
{
"app_id": "qobuz app id"
.....
}
</tt>
* <tt>Status</tt> from <tt>Get</tt> is blank if <tt>Username</tt> and <tt>Password</tt> are both either blank or set and valid. If <tt>Status</tt> is not blank, it contains either JSON returned from a Qobuz API or an error string.
* The token returned from <tt>Login</tt> and <tt>Relogin</tt> is JSON and contains at least the <tt>user_auth_token</tt> required by some Qobuz calls.
<tt>
{
"user_auth_token": "[token from qobuz]"
.....
}
</tt>

Some Qobuz APIs require an <tt>app_secret</tt> argument. These APIs should not need to be called from control points. Qobuz's standard development agreement prohibits this being shared between device and control point.

Tracks can be added to the [[Av:Developer:Eriskay:PlaylistService | Playlist]] service with urls in the form
<tt>
qobuz://track?version=2&trackId=[qobuz_track_id]
</tt>

Av:Developer:Eriskay:StreamingServices - Revision history

Simonc: Created page with "= Streaming Services = == TIDAL == Tidal's API is private. See Tidal for access to it. Or speak to us for help if you think that your access to the API would benefit OpenHome. ..."