Document processHTML
[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   See `bosh v2 header set`_, plus:
14
15   ``t_auth_token``
16     OAuth token obtained from `POST https://thalia.de/auth/oauth2/token`_.
17
18     Example: ``eyJhbGciOiJSUzI1NiJ9.eyJhdWRpZW5jZSI6InRyZWFkZXJ2aXNpb24zIiw...``
19   ``reseller_id``
20     Example: ``3``
21   ``Content-Type``
22     ``text/plain; charset=UTF-8``
23
24     This is a lie, because the request body is JSON.
25
26 Body
27   .. include:: pageplace.bosh-bosh-rest-v2-registerhw.request.json
28      :code:
29
30
31 Response
32 ========
33 HTTP status code: ``200 OK``
34
35 Contains a device key, the changelog in several languages and
36 the latest firmware version including its download URL.
37
38 Example:
39
40 .. include:: pageplace.bosh-bosh-rest-v2-registerhw.response.json
41    :code: