summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--implementations.rst (renamed from json/implementations.rst)18
-rw-r--r--index.rst1
-rw-r--r--json/index.rst1
-rw-r--r--rest/authentication.rst2
-rw-r--r--rest/implementations.rst11
-rw-r--r--rest/index.rst9
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/
diff --git a/index.rst b/index.rst
index bd2c377..b50ca06 100644
--- a/index.rst
+++ b/index.rst
@@ -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=