Add usage information for several endpoints

[ouya-store-api.git] / api / devs.ouya.tv / api-v1-sessions.rst

diff --git a/api/devs.ouya.tv/api-v1-sessions.rst b/api/devs.ouya.tv/api-v1-sessions.rst
index 5c682ad68807614bc726fd0ba0cd5e119502617c..75109a395babdb738cbc7586d819cb402bb613fd 100644 (file)
--- a/api/devs.ouya.tv/api-v1-sessions.rst
+++ b/api/devs.ouya.tv/api-v1-sessions.rst
@@ -9,12 +9,20 @@ This token is stored in the console and used in the
 ``auth_token`` GET parameter.
 
 
+Usage
+=====
+
+#. After logging with an existing account
+#. After new user registration
+#. When visiting Manage > Accounts
+
+
 HTTP request
 ============
 Protocol
   ``https``
 Method
-  ``GET``
+  ``POST``
 Host
   ``devs.ouya.tv``
 Path
@@ -40,14 +48,17 @@ Success
 -------
 When the user logged in successfully.
 
+.. note:: If the user is already logged in, the old ``auth_token`` is returned.
+          No new token is issued in this case.
+
 Status code
-  ``200 OK`` 
+  ``200 OK``
 Content type
   ``application/json; charset=utf-8``
 
 Response body example:
 
-.. include:: api-v1-sessions-response-valid.json
+.. include:: api-v1-sessions.response-valid.json
    :code:
 
 
@@ -66,5 +77,5 @@ Content type
 
 Response body example:
 
-.. include:: api-v1-sessions-response-invalid.json
+.. include:: api-v1-sessions.response-invalid.json
    :code: