diff options
| -rw-r--r-- | implementations.rst (renamed from json/implementations.rst) | 18 | ||||
| -rw-r--r-- | index.rst | 1 | ||||
| -rw-r--r-- | json/index.rst | 1 | ||||
| -rw-r--r-- | rest/authentication.rst | 2 | ||||
| -rw-r--r-- | rest/implementations.rst | 11 | ||||
| -rw-r--r-- | rest/index.rst | 9 |
6 files changed, 16 insertions, 26 deletions
diff --git a/json/implementations.rst b/implementations.rst index 72d3794..49c0051 100644 --- a/json/implementations.rst +++ b/implementations.rst @@ -9,16 +9,16 @@ Implementations A list of open source Pandora JSON API implementations. .. csv-table:: - :header: Name, Used in client, Language, Remarks + :header: Name,Used in client,Language,API Version,Remarks - libpiano_, "pianobar_, pianod_", C,"" - Pandora_, Hermes_, Objective-C,"" - pydora_ (`PyPI`__), "`pydora player`_, pancake_, `mopidy-pandora`_", "Python", "Python 2.7+ and 3.3+ compatible" - `pithos.pandora`_, Pithos_, Python,"" - PandoraSharp_, Elpis_, C#, Not to be confused with the `original PandoraSharp`_ (uses XMLRPC) - libpanda_, Mousiki_, Vala,"" - gopiano_, , Go, "" - `WebService::Pandora`_, , Perl, "Perl 5.6+ compatible" + libpiano_, "pianobar_, pianod_", C,JSON v5,"" + Pandora_, Hermes_, Objective-C,JSON v5,"" + pydora_ (`PyPI`__), "`pydora player`_, pancake_, `mopidy-pandora`_", "Python", JSON v5,"Python 2.7+ and 3.3+ compatible" + `pithos.pandora`_, Pithos_, Python,JSON v5,"" + PandoraSharp_, Elpis_, C#,JSON v5, Not to be confused with the `original PandoraSharp`_ (uses XMLRPC) + libpanda_, Mousiki_, Vala,JSON v5,"" + gopiano_, , Go,JSON v5, "" + `WebService::Pandora`_, , Perl,JSON v5, "Perl 5.6+ compatible" .. _libpiano: https://github.com/PromyLOPh/pianobar/tree/master/src/libpiano .. _pianobar: http://6xq.net/projects/pianobar/ @@ -24,5 +24,6 @@ Suggestions and patches are welcome. .. toctree:: :maxdepth: 2 + implementations json/index rest/index diff --git a/json/index.rst b/json/index.rst index f139488..1a7f576 100644 --- a/json/index.rst +++ b/json/index.rst @@ -85,7 +85,6 @@ message whereas successful requests carry actual response data in the key ads methods errorcodes - implementations .. toctree:: :hidden: diff --git a/rest/authentication.rst b/rest/authentication.rst index 763ddcc..191da4e 100644 --- a/rest/authentication.rst +++ b/rest/authentication.rst @@ -9,7 +9,7 @@ Authentication User Login ========== -:Endpoint: /v1/login +:Endpoint: /v1/auth/login Request ------- diff --git a/rest/implementations.rst b/rest/implementations.rst deleted file mode 100644 index 06cbcf7..0000000 --- a/rest/implementations.rst +++ /dev/null @@ -1,11 +0,0 @@ -=============== -Implementations -=============== - -.. index:: - single: Implementations - -A list of open source Pandora REST API implementations. - -.. csv-table:: - :header: Name, Used in client, Language, Remarks diff --git a/rest/index.rst b/rest/index.rst index a0cd991..f43d797 100644 --- a/rest/index.rst +++ b/rest/index.rst @@ -12,7 +12,6 @@ REST API ads endpoints errorcodes - implementations The Pandora REST API is used by modern Pandora apps including the website and the various mobile apps provided by Pandora. The current REST API has multiple @@ -23,9 +22,9 @@ feature set evolves. The main endpoint is: - https://www.pandora.com/api/ All requests are JSON-encoded and sent via HTTP POST body to the endpoints over -HTTPS. Response bodies are JSON-encoded values. Unlike the JSON v5 API there is -no requirement for time syncronization, Blowfish cryptography, or partner -logins. +HTTPS. Requests require a ``Content-Type`` header of ``application/json``. +Response bodies are JSON-encoded values. Unlike the JSON v5 API there is no +requirement for time syncronization, Blowfish cryptography, or partner logins. The API requires a cookie aware client as several cookies will be issued during authentication that **must** be present in every request. Failure to provide @@ -48,6 +47,7 @@ cookie in each request. POST /api/v1/auth/login HTTP/1.1 Host: www.pandora.com + Content-Type: application/json;charset=utf-8 X-CsrfToken: 123456a7889b1c23 X-AuthToken: @@ -65,6 +65,7 @@ the auth token obtained during login. It is acceptable to include the POST /api/v1/station/getStations HTTP/1.1 Host: www.pandora.com + Content-Type: application/json;charset=utf-8 X-CsrfToken: 123456a7889b1c23 X-AuthToken: dGhpcyBpcyBqdXN0IGFuIGV4YW1wbGUgY29kZQo= |