Razer Forge TV login endpoints

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

diff --git a/api/devs.ouya.tv/api-v1-discover.rst b/api/devs.ouya.tv/api-v1-discover.rst
index e06e2b979a8ca195bb6e2f89251158e8a2217f32..0bc4039976a7be7c8d69be181f07ab47498a402f 100644 (file)
--- a/api/devs.ouya.tv/api-v1-discover.rst
+++ b/api/devs.ouya.tv/api-v1-discover.rst
@@ -29,6 +29,8 @@ Status code
 Content-type
   ``application/json; charset=utf-8``
 
+HTTP redirects (e.g. 302) are supported.
+
 Response body definition
 ------------------------
 JSON object with two properties: ``rows`` and ``tiles``.
@@ -149,7 +151,7 @@ The position in the ``tiles`` array is the ID used by ``rows/tiles``.
   ``versionNumber``
     string with current version, e.g. ``1.11``
   ``uuid``
-    ???
+    UUID of the release.
 ``package``
   string
 
@@ -157,13 +159,14 @@ The position in the ``tiles`` array is the ID used by ``rows/tiles``.
 ``premium``
   ``true`` or ``false``
 
-  FIXME: What is that for?
+  When ``true``, the game has no demo version and has to be bought before
+  it can be downloaded.
 ``promotedProduct``
   object
 
   Bundles do not have this property set.
 
-  ??? FIXME: What is that for?
+  The "buy" button buys this product.
 
   ``currency``
     string
@@ -248,3 +251,6 @@ Example
 
 .. include:: api-v1-discover.response.json
    :code:
+
+The API git repository contains a full copy of the "discover" response
+at ``api/devs.ouya.tv/api-v1-discover.response-full.json``.