Work in progress #5: Uploading and deleting own ebooks
[tolino-api-docs.git] / api / pageplace.bosh-bosh-rest-v2-registerhw.rst
1 ==========================================================
2 ``POST https://bosh.pageplace.de/bosh/rest/v2/registerhw``
3 ==========================================================
4 Step 6 in the `Login process`_.
5
6 Register the e-book reader's hardware ID with the user account.
7
8
9 Request
10 =======
11
12 Header
13   ``t_auth_token``
14     OAuth token obtained from `POST https://thalia.de/auth/oauth2/token`_.
15
16     Example: ``eyJhbGciOiJSUzI1NiJ9.eyJhdWRpZW5jZSI6InRyZWFkZXJ2aXNpb24zIiw...``
17   ``reseller_id``
18     Example: ``3``
19   ``hardware_type``
20     Example: ``tolino_vision_3``
21   ``os_version``
22     Example: ``4.4.2``
23   ``language_code``
24     Example: ``en``
25   ``hardware_id``
26     Example: ``665fc389ef4e47258c5db9fa7821bd19``
27   ``client_type``
28     Example: ``TOLINO_VISION_3``
29   ``client_version``
30     Example: ``14.1.0``
31   ``Content-Type``
32     ``text/plain; charset=UTF-8``
33
34     This is a lie, because the request body is JSON.
35
36 Body
37   .. include:: pageplace.bosh-bosh-rest-v2-registerhw.request.json
38      :code:
39
40
41 Response
42 ========
43 HTTP status code: ``200 OK``
44
45 Contains a device key, the changelog in several languages and
46 the latest firmware version including its download URL.
47
48 Example:
49
50 .. include:: pageplace.bosh-bosh-rest-v2-registerhw.response.json
51    :code: