Some details info
[ouya-store-api.git] / api / devs.ouya.tv / api-v1-developers-xxx-products.rst
1 ============================================================
2 ``GET https://devs.ouya.tv/api/v1/developers/xxx/products/``
3 ============================================================
4
5 Use in-game when purchasing a feature, sometimes already at game startup.
6
7 Some games rely on this to check if the game is purchasable at all.
8 If the product list does not contain the product identifier they
9 expect, buying is not possible. (Example: ``com.sega.sonic4epi``)
10
11 Usage
12 =====
13 - When the user starts a game and pressed "Sync" in the store
14   (at "Babylonian Twins")
15
16
17 HTTP request
18 ============
19 Protocol
20   ``https``
21 Method
22   ``GET``
23 Host
24   ``devs.ouya.tv``
25 Path
26   ``/api/v1/developers/xxx/products/``
27
28   ``xxx``
29     Developer UUID
30
31   Example: ``/api/v1/developers/c4e46efe-05fd-4be9-9d7e-1f7607eabd49/products/``
32 Headers
33   Standard headers
34 GET parameters
35   ``auth_token``
36     Same as ``X-OUYA-AuthToken``
37   ``only``
38     Product key (same as ``Identifier`` in ``promotedProduct`` of app details)
39
40     Example: ``&only=unlock_pro``
41
42
43 HTTP response
44 =============
45 Status code
46   ``200 OK``
47 Content-type
48   ``application/json; charset=utf-8``
49
50 Example
51 -------
52
53 .. include:: api-v1-developers-xxx-products.response.json
54    :code: