document discover search
[ouya-store-api.git] / api / devs.ouya.tv / api-v1-events.rst
1 ===========================================
2 ``POST https://devs.ouya.tv/api/v1/events``
3 ===========================================
4
5 Send information about the last events on the OUYA console to the
6 logging/tracking server.
7
8
9 Usage
10 =====
11
12 #. Every now and then when enough events have been collected
13
14    FIXME: determine exact behavior
15
16
17 HTTP request
18 ============
19 Protocol
20   ``https``
21 Method
22   ``POST``
23 Host
24   ``devs.ouya.tv``
25 Path
26   ``/api/v1/events``
27 Headers
28   Standard headers
29
30   ``Content-Type``
31     ``application/x-www-form-urlencoded``
32 POST parameters
33   ``current_time``
34     ``1434577856574``
35
36     Some time stamp.
37
38     FIXME: which format?
39   ``console_id``
40     Same data as in standard header ``X-OUYA-Console-Id``
41   ``events``
42     JSON-encoded array of event objects
43   ``auth_token``
44     Same data as in standard header ``X-OUYA-AuthToken``
45
46 Example event JSON data:
47
48 .. include:: api-v1-events.request.json
49    :code:
50    :end-line: 30
51
52
53 HTTP response
54 =============
55 Status code
56   ``200 OK`` 
57 Content type
58   ``application/json; charset=utf-8``
59 Body
60   ``{}``