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 c140919a0f9d711471b9b08a5e21927e783375c5..75109a395babdb738cbc7586d819cb402bb613fd 100644 (file)
--- a/api/devs.ouya.tv/api-v1-sessions.rst
+++ b/api/devs.ouya.tv/api-v1-sessions.rst
@@ -14,6 +14,7 @@ Usage
 
 #. After logging with an existing account
 #. After new user registration
+#. When visiting Manage > Accounts
 
 
 HTTP request
@@ -21,7 +22,7 @@ HTTP request
 Protocol
   ``https``
 Method
-  ``GET``
+  ``POST``
 Host
   ``devs.ouya.tv``
 Path
@@ -47,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:
 
 
@@ -73,5 +77,5 @@ Content type
 
 Response body example:
 
-.. include:: api-v1-sessions-response-invalid.json
+.. include:: api-v1-sessions.response-invalid.json
    :code: