more information about purchasing

diff --git a/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.request-nocrypt.json b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.request-nocrypt.json
new file mode 100644 (file)
index 0000000..3fc75e7
--- /dev/null
+++ b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.request-nocrypt.json
@@ -0,0 +1 @@
+blob=eyAia2V5IiA6ICJHcnl0dnRSYjY5TDh6L3pIT3RTdGFnPT0iLCAiaXYiIDogIjZzMDd3OGo3VFNleVhQdzBsMXdvRUE9PSIsICJibG9iIiA6ICJleUpwWkdWdWRHbG1hV1Z5SWpvaVoyOWlYMloxYkd4ZloyRnRaVjkxYm14dlkyc2lMQ0owWlhOMGFXNW5Jam9pZEhKMVpTSXNJblYxYVdRaU9pSTNOak0xTjJFME9XRm1NVFk0WWpJNUluMD0iIH0%3D&iv=QHpnmyEf7BGZhTnK37NggQ%3D%3D&key=bdR0jZ22clKqJwOsyYdn8w%3D%3D&auth_token=00702342-0000-1111-2222-c3e1500cafe1

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
index 55db3b122cd57edb857310af18abfcd25fb86426..6babf3a1818709bad6e48c58276146646718e7d4 100644 (file)
--- a/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst
+++ b/api/devs.ouya.tv/api-v1-games-xxx-purchases.post.rst
@@ -44,11 +44,14 @@ POST parameters
   ``iv``
     Base64-encoded initialization vector for the cryptographic function
   ``key``
-    Base64-encoded key used to encrypt the data. FIXME: symmetric or assymetric?
+    Base64-encoded key used to encrypt the ``blob``.
+    Encrypted with FIXME: gamer key or developer key.
   ``auth_token``
     Same as ``X-OUYA-AuthToken``
 
-The decrypted ``blob`` contains a JSON object:
+The decrypted ``blob`` again contains ``blob``, ``key`` and ``iv``.
+
+The decrypted inner ``blob`` contains a JSON object:
 
 ``identifier``
   Product key
@@ -58,6 +61,13 @@ The decrypted ``blob`` contains a JSON object:
   Random number that is used by the game for this purchase request.
   Must be returned in the response to this request.
 
+Raw request (without encryption):
+
+.. include:: api-v1-games-xxx-purchases.post.request-nocrypt.json
+   :code:
+
+Decrypted:
+
 .. include:: api-v1-games-xxx-purchases.post.request-decrypted.json
    :code:
 
@@ -72,7 +82,13 @@ Content-type
 Again the base-64 encoded keys: ``iv``, ``key`` and ``blob``.
 
 ``blob`` is a JSON object that needs to contain the ``uuid`` property.
-Other properties in the response are unknown.
+Most games do not want any other properties.
+
+"God of Blades" requires:
+
+- ``identifier``
+- ``name``
+- ``priceInCents``
 
 Example
 -------