api/pageplace.bosh-bosh-rest-handshake-resellers.rst

   1 ===============================================================
   2 ``GET https://bosh.pageplace.de/bosh/rest/handshake/resellers``
   3 ===============================================================
   4
   5 Get a list of resellers (book shops) that can be selected when
   6 the Tolino reader is unlocked.
   7
   8 It is also used when linking the Tolino to another account on
   9 a different book seller. (FIXME: verify)
  10
  11 Part of the `sync process`_.
  12
  13
  14 Request
  15 =======
  16 Header
  17   ``t_auth_token``
  18     OAuth token obtained from `POST https://thalia.de/auth/oauth2/token`_.
  19
  20     Example: ``eyJhbGciOiJSUzI1NiJ9.eyJhdWRpZW5jZSI6InRyZWFkZXJ2aXNpb24zIiw...``
  21   ``Accept``
  22     Example: ``application/json; charset=UTF-8``
  23   ``m_id``
  24     FIXME: Maybe reseller ID?
  25
  26     Example: ``3``
  27   ``hardware_id``
  28     Seems to be the same as the ``xxx`` value in the URL.
  29
  30     Example: ``665fc389ef4e47258c5db9fa7821bd19``
  31   ``Content-Type``
  32     ``application/json; charset=UTF-8``
  33
  34     This is a lie; there is no request body.
  35   ``client_type``
  36     Example: ``TOLINO_VISION_3``
  37   ``client_version``
  38     Example: ``14.1.0``
  39
  40
  41 Response
  42 ========
  43 HTTP status code ``200 OK``.
  44
  45 Example:
  46
  47 .. include:: pageplace.bosh-bosh-rest-handshake-resellers.response.json
  48    :code: