Some details info

[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 961dba7197d578a201dc8810391c7ed5e0db6af8..214791c3d47217d47a1e848a411b8803a02d7002 100644 (file)
--- a/api/devs.ouya.tv/api-v1-discover.rst
+++ b/api/devs.ouya.tv/api-v1-discover.rst
@@ -149,7 +149,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 +157,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
@@ -227,10 +228,15 @@ The position in the ``tiles`` array is the ID used by ``rows/tiles``.
 ``url``
   string
 
-  ``ouya://launcher/details?app=evil.corptron.DuckGame``
-
   URL for the game details page
 
+  Game details
+    ``ouya://launcher/details?app=evil.corptron.DuckGame``
+  Bundle details
+    ``ouya://launcher/details?page=be239ca4-10fd-42dd-89cd-1806e80b1362``
+
+    See `GET https://devs.ouya.tv/api/v1/details`_.
+
 ``title``
 ---------
 string
@@ -243,3 +249,7 @@ 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``.
+