PUT https://devs.ouya.tv/api/v1/gamers/key

diff --git a/README.rst b/README.rst
index 83b1f282d2f490735b95029a6b42dd01a7bdb6e8..e914a395c7f33387354652557662c6e473e74e5f 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -19,6 +19,7 @@ speak with ``devs.ouya.tv``.
 .. include:: api/devs.ouya.tv/api-v1-discover-home.rst
 .. include:: api/devs.ouya.tv/api-v1-events.rst
 .. include:: api/devs.ouya.tv/api-v1-gamers.rst
+.. include:: api/devs.ouya.tv/api-v1-gamers-key.put.rst
 .. include:: api/devs.ouya.tv/api-v1-gamers-me.rst
 .. include:: api/devs.ouya.tv/api-v1-gamers-me-agreements.rst
 .. include:: api/devs.ouya.tv/api-v1-gamers-me-agreements.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
new file mode 100644 (file)
index 0000000..f300dd6
--- /dev/null
+++ b/api/devs.ouya.tv/api-v1-gamers-key.put.rst
@@ -0,0 +1,59 @@
+==============================================
+``PUT https://devs.ouya.tv/api/v1/gamers/key``
+==============================================
+
+Store an encryption key on the server
+
+FIXME: When is that key needed?
+
+HTTP request
+============
+Protocol
+  ``https``
+Method
+  ``PUT``
+Host
+  ``devs.ouya.tv``
+Path
+  ``/api/v1/gamers/key``
+Headers
+  Standard headers
+
+  ``Content-Type``
+    ``application/x-www-form-urlencoded``
+GET parameters
+  ``auth_token``
+    Same data as in standard header ``X-OUYA-AuthToken``
+POST parameters
+  ``auth_token``
+    Same data as in standard header ``X-OUYA-AuthToken``
+  ``gamer[key]``
+    string
+
+    FIXME encryption key
+  ``gamer[password]``
+    string
+
+    User account password
+  ``gamer[username]``
+    string
+
+    User account name
+
+Example key::
+
+  -----BEGIN PUBLIC KEY-----
+  MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCvf3MvvZui5shNGbt2O0zveXrtfHZNivowNKiO
+  UagJARKCJmjOJVtZ1srCe95Eul/xBDPDEaH8vJetn5Pl99QwhdYL1ps9mUhmocx90LavQsipr2Dw
+  B7XshwN/EpW0uR/R84a3yXozpk7dgXi4+y//A+XT+MqgxsY6cdSGrBMsCQIDAQAB
+  -----END PUBLIC KEY-----
+
+
+HTTP response
+=============
+Status code
+  ``201 Created``
+Content type
+  ``application/json; charset=utf-8``
+Body
+  ``{}``