POST purchases

diff --git a/README.rst b/README.rst
index 52702289e33840de337e5a9ff25bd2d2c33e8dd6..c066bf1a9dcacb09fb50f5bb4d12836d7121ee7f 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -29,6 +29,7 @@ speak with ``devs.ouya.tv``.
 .. include:: api/devs.ouya.tv/api-v1-gamers-me-consoles.rst
 .. include:: api/devs.ouya.tv/api-v1-gamers-me-user_messages.rst
 .. include:: api/devs.ouya.tv/api-v1-games-xxx-purchases.rst
+.. include:: api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst
 .. include:: api/devs.ouya.tv/api-v1-premium_purchases.rst
 .. include:: api/devs.ouya.tv/api-v1-queued_downloads-xxx.delete.rst
 .. include:: api/devs.ouya.tv/api-v1-queued_downloads.rst

diff --git a/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.response.json b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.response.json
new file mode 100644 (file)
index 0000000..bf0fa5a
--- /dev/null
+++ b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.response.json
@@ -0,0 +1,5 @@
+{
+  "blob": "YKNolqKuaDcQnqQH8yncS+0hVl/YnajMgnojfMaO2IzUpfVg4lBVrz5NF30N\nXUkgpBTnXdcPUalv7YvWsqT9b8Tdm5PYgoduqi2zLyXF+bSWY+bBigDX+MDG\nyvgxjfpYcWeyYaNLn2vhsj0rVNVorT5CggAXrry2eeUIFOX+9IUzbHmxfiqP\nlglVtrudwzQO1PS5n3KNJnHfp+r7vgBG5DzErUK4YHUYBe4/9li313tEIwnK\nX4kDZXSzKiZ2SPfyYTaVgIr82x9GDaIa1ZXIBuFlQSUo55A5Gy7Wy9rTDzMb\n80LdsNlbHeOiSIBN7Rj7CuOu7Uz5btuWLCpmCHZ2xgyhN6I9y2/KTNYa2JIA\n/9fsBGcrdkiu4f3aKdiZlI8bh07npp10KpQEMszz59xr5V6h0Xjjcgw95SaE\nDmxxz3LSRVtNpjGsTlqsb4Jnc/fKcMrJcmzoDLAodfgnSev8hrNUmgs6f/df\neXKQ0J6JuiWAgKXUZ9g5GEkUn0uIo3RzIyVqRIJL9zM6oeaZ487zG1X2e5Xy\noCc1x6GKQpGr9Qp+hRp6HSp8NUyR2ZziD+DSHbZeDaZdu3bbWrzIDEVJLpwU\noVROZR2nqyR9i3eQlpvSJGUPBM9pi8KdYTvOuBKB9hrz1XYe8852bFsbn0G/\np8nmKKPM0xDc0gHuScLfUZQ=\n",
+  "iv": "wV8mnhuGz7YaxNSP1QWfVQ==\n",
+  "key": "hxvgGjQWJJ8vSidCF5eP4JC1VqUjZxL+ZLq9p6BrbuhSMqvtFU/YZxinKTeD\nMkCnK3Ie0lP8OoKGFl21F+/5rOuybD+FKfVJdXwIsA1ryjkFi8KBMq2G+YWo\nxMM9T0zdkOKiidK1GYHqJyLlVLrEC+qaLSqSPEoL9R0ovZhy64c=\n"
+}

diff --git a/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst
new file mode 100644 (file)
index 0000000..55c1614
--- /dev/null
+++ b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst
@@ -0,0 +1,63 @@
+========================================================
+``POST https://devs.ouya.tv/api/v1/games/xxx/purchases``
+========================================================
+
+Buy a game.
+
+After buying the game shows up in 
+`GET https://devs.ouya.tv/api/v1/premium_purchases`_.
+
+
+Usage
+=====
+- When the user buys an app/game.
+
+
+HTTP request
+============
+Protocol
+  ``https``
+Method
+  ``POST``
+Host
+  ``devs.ouya.tv``
+Path
+  ``/api/v1/games/xxx/purchases``
+
+  ``xxx``
+    app package name
+
+  Example: ``/api/v1/games/com.ChrisChung.CatlateralDamage/purchases``
+Headers
+  Standard headers
+
+  ``Content-Type``
+    ``application/x-www-form-urlencoded``
+GET parameters
+  ``auth_token``
+    Same as ``X-OUYA-AuthToken``
+  ``user_agent``
+    ``launcher`` (at least when bought through the OUYA UI)
+POST parameters
+  ``blob``
+    Encrypted data
+  ``iv``
+    FIXME: Initialization vector for the cryptographic function
+  ``key``
+    FIXME: Key used to encrypt the data. FIXME: symmetric or assymetric?
+  ``auth_token``
+    Same as ``X-OUYA-AuthToken``
+
+
+HTTP response
+=============
+Status code
+  ``200 OK``
+Content-type
+  ``application/json; charset=utf-8``
+
+Example
+-------
+
+.. include:: api-v1-games-xxx-purchases.post.response.json
+   :code: