Add usage information for several endpoints

[ouya-store-api.git] / api / devs.ouya.tv / api-v1-gamers-key.put.rst

diff --git a/api/devs.ouya.tv/api-v1-gamers-key.put.rst b/api/devs.ouya.tv/api-v1-gamers-key.put.rst
index f300dd6c598ecca1c93e866da9d0c029199ec9aa..e22ddeeb103f14949d0c539a547146ad9add3afe 100644 (file)
--- a/api/devs.ouya.tv/api-v1-gamers-key.put.rst
+++ b/api/devs.ouya.tv/api-v1-gamers-key.put.rst
@@ -2,9 +2,19 @@
 ``PUT https://devs.ouya.tv/api/v1/gamers/key``
 ==============================================
 
-Store an encryption key on the server
+Store the user's public key on the server.
+
+Receipts/purchases are encryptd by the server with the user's public key,
+so that only that user can decrypt it.
+
+
+Usage
+=====
+
+#. Once per bootup just before purchases are checked the first time.
+   That can be when opening "Play" that contains purchasable games,
+   or "Discover" showing purchasable games.
 
-FIXME: When is that key needed?
 
 HTTP request
 ============