.. include:: api/pageplace.bosh-bosh-rest-userid-xxx.rst
.. include:: api/pageplace.bosh-bosh-rest-v2-registerhw.rst
.. include:: api/pageplace.bosh-bosh-rest-v2-resellerconfig.rst
+.. include:: api/pageplace.bosh-bosh-rest-v2-versioncheck.rst
.. include:: api/pageplace.family-v1-family.rst
.. include:: api/pageplace.family-v1-family-post.rst
.. include:: api/pageplace.family-v1-family-members-xxx.rst
Example: ``14.1.0``
+bosh v2 header set
+==================
+Headers common in all HTTP requests to ``https://bosh.pageplace.de/bosh/rest/v2/...``.
+
+``hardware_type``
+ Example: ``tolino_vision_3``
+``os_version``
+ Android version
+
+ Example: ``4.4.2``
+``language_code``
+ Example: ``en``
+``hardware_id``
+ Example: ``665fc389ef4e47258c5db9fa7821bd19``
+``client_type``
+ Example: ``TOLINO_VISION_3``
+``client_version``
+ Tolino firmware version
+
+ Example: ``14.1.0``, ``15.2.0``
+
+
+
+
family v1 header set
====================
``Authorization``
``epublishing://openbook``
FIXME
+ Parameters:
+ ``deliverableid``
+ FIXME
+
``epublishing://openbook_skoti``
FIXME
``epublishing://openextract``
FIXME
+ Parameters (all 4 must be passed):
+ ``extractcoverurl``
+ FIXME
+
+ ``extractdeliverableid``
+ FIXME
+
+ ``extractdownloadurl``
+ FIXME
+
+ ``extractpurchaseurl``
+ FIXME
+
+
``epublishing://opensearchresult``
FIXME
``epublishing://requestauth``
- FIXME
+ FIXME "Open login"
+
+ Parameters:
+ ``loginfailureurl``
+ FIXME
+
+ ``targeturl``
+ FIXME
``epublishing://resellerChangeFinishFactoryReset``
FIXME
``epublishing://search``
FIXME
+
+ Parameters:
+ ``q``
+ Search term
========
HTTP status code ``200 OK``.
-Example:
+
+Response body definition
+------------------------
+
+``publicationType``
+ Can be empty or one of: ``EBOOK``, ``EMAGAZINE``, ``EPAPER`` or ``EDATA``.
+ Not used.
+
+
+Example
+-------
.. include:: pageplace.bosh-bosh-rest-recommendation-xyz.response.json
:code:
=======
Header
+ See `bosh v2 header set`_, plus:
+
``t_auth_token``
OAuth token obtained from `POST https://thalia.de/auth/oauth2/token`_.
Example: ``eyJhbGciOiJSUzI1NiJ9.eyJhdWRpZW5jZSI6InRyZWFkZXJ2aXNpb24zIiw...``
``reseller_id``
Example: ``3``
- ``hardware_type``
- Example: ``tolino_vision_3``
- ``os_version``
- Example: ``4.4.2``
- ``language_code``
- Example: ``en``
- ``hardware_id``
- Example: ``665fc389ef4e47258c5db9fa7821bd19``
- ``client_type``
- Example: ``TOLINO_VISION_3``
- ``client_version``
- Example: ``14.1.0``
``Content-Type``
``text/plain; charset=UTF-8``
Request
=======
Header
+ See `bosh v2 header set`_, plus:
+
``ifmodifiedsince``
Timestamp with microseconds of last reseller config file version
Example: ``1603111725000``
``reseller_id``
Example: ``3``
-
- Required. "400 Bad Request" if missing.
- ``hardware_type``
- Example: ``tolino_vision_3``
- ``os_version``
- Android version
-
- Example: ``4.4.2``
- ``language_code``
- Example: ``en``
- ``hardware_id``
- Example: ``665fd389ea4e47228c5db8fa7821bd23``
``client_type``
- Example: ``TOLINO_VISION_3``
-
Required. "400 Bad Request" if missing.
- ``client_version``
- Tolino firmware version
-
- Example: ``14.1.0``
Response
--- /dev/null
+{"initAppRequest":{"hardware_id":"665fc389ef4e47258c5db9fa7821bd19","hardware_name":"","client_type":"TOLINOVISION3_15.2.0","hardware_type":"tolino_vision_3"}}
--- /dev/null
+{
+ "initAppResponse": {
+ "deviceKey": "",
+ "update": 0,
+ "updateVersion": "15.2.0",
+ "userId": "",
+ "config": [
+ {
+ "key": "CHANGELOG_NL",
+ "value": "Met deze update hebben we de zoekmachine van de webbrowser gewijzigd in een meer privacyvriendelijke service. Verder hebben we de levensduur van de batterij verbeterd, de prestaties verbeterd en meer stabiliteit aan uw tolino toegevoegd."
+ },
+ {
+ "key": "CHANGELOG_EN",
+ "value": "With this update we have changed the web browser search engine to more privacy friendly service. Furthermore, we have improved the battery life, enhanced the performance and added more stability to your tolino."
+ },
+ {
+ "key": "CHANGELOG_FR",
+ "value": "Avec cette mise à jour, nous avons changé le moteur de recherche du navigateur web pour un service plus respectueux de la vie privée. De plus, nous avons amélioré l'autonomie de la batterie, les performances et la stabilité de votre tolino."
+ },
+ {
+ "key": "DOWNLOAD_FILE_MD5",
+ "value": "9bebf4437a81cfe1106f89b44e611dd6"
+ },
+ {
+ "key": "CHANGELOG_ES",
+ "value": "Con esta actualización hemos cambiado el motor de búsqueda del navegador por un servicio más respetuoso con la privacidad. Además, hemos mejorado la duración de la batería, incrementado el rendimiento y añadido más estabilidad en tu tolino."
+ },
+ {
+ "key": "CHANGELOG_DE",
+ "value": "Mit diesem Update haben wir die Suchmaschine im Browser auf einen datenschutzfreundlicheren Anbieter umgestellt sowie Deinen tolino weiter optimiert, indem wir die Fehler behoben und die Stabilität sowie die Batterielaufzeit erhöht haben. Genieße nun wie gewohnt weiter spannende Lese-Abenteuer auf Deinem tolino!"
+ },
+ {
+ "key": "DOWNLOAD_URL",
+ "value": "https://download.pageplace.de/ereader/15.2.0/OS44/update.zip"
+ },
+ {
+ "key": "CHANGELOG_IT",
+ "value": "Con questo aggiornamento abbiamo cambiato il motore di ricerca del browser web con un servizio più rispettoso della privacy. Inoltre, abbiamo migliorato la durata della batteria, migliorato le prestazioni ed aggiunto più stabilità al tuo tolino."
+ }
+ ]
+ }
+}
--- /dev/null
+{
+ "initAppResponse": {
+ "deviceKey": "",
+ "update": 2,
+ "updateVersion": "15.2.0",
+ "userId": "",
+ "config": [
+ {
+ "key": "CHANGELOG_NL",
+ "value": "Met deze update hebben we de zoekmachine van de webbrowser gewijzigd in een meer privacyvriendelijke service. Verder hebben we de levensduur van de batterij verbeterd, de prestaties verbeterd en meer stabiliteit aan uw tolino toegevoegd."
+ },
+ {
+ "key": "CHANGELOG_EN",
+ "value": "With this update we have changed the web browser search engine to more privacy friendly service. Furthermore, we have improved the battery life, enhanced the performance and added more stability to your tolino."
+ },
+ {
+ "key": "CHANGELOG_FR",
+ "value": "Avec cette mise à jour, nous avons changé le moteur de recherche du navigateur web pour un service plus respectueux de la vie privée. De plus, nous avons amélioré l'autonomie de la batterie, les performances et la stabilité de votre tolino."
+ },
+ {
+ "key": "DOWNLOAD_FILE_MD5",
+ "value": "9bebf4437a81cfe1106f89b44e611dd6"
+ },
+ {
+ "key": "CHANGELOG_ES",
+ "value": "Con esta actualización hemos cambiado el motor de búsqueda del navegador por un servicio más respetuoso con la privacidad. Además, hemos mejorado la duración de la batería, incrementado el rendimiento y añadido más estabilidad en tu tolino."
+ },
+ {
+ "key": "CHANGELOG_DE",
+ "value": "Mit diesem Update haben wir die Suchmaschine im Browser auf einen datenschutzfreundlicheren Anbieter umgestellt sowie Deinen tolino weiter optimiert, indem wir die Fehler behoben und die Stabilität sowie die Batterielaufzeit erhöht haben. Genieße nun wie gewohnt weiter spannende Lese-Abenteuer auf Deinem tolino!"
+ },
+ {
+ "key": "DOWNLOAD_URL",
+ "value": "https://download.pageplace.de/ereader/15.2.0/OS44/update.zip"
+ },
+ {
+ "key": "CHANGELOG_IT",
+ "value": "Con questo aggiornamento abbiamo cambiato il motore di ricerca del browser web con un servizio più rispettoso della privacy. Inoltre, abbiamo migliorato la durata della batteria, migliorato le prestazioni ed aggiunto più stabilità al tuo tolino."
+ }
+ ]
+ }
+}
--- /dev/null
+============================================================
+``POST https://bosh.pageplace.de/bosh/rest/v2/versioncheck``
+============================================================
+
+Was not used in firmware 13.
+
+
+Request
+=======
+
+Header
+ See `bosh v2 header set`_, plus:
+
+ ``Content-Type``
+ ``text/plain; charset=UTF-8``
+
+ This is a lie, because the request body is JSON.
+
+Body
+ .. include:: pageplace.bosh-bosh-rest-v2-versioncheck.request.json
+ :code:
+
+
+Response
+========
+
+Example: Update available
+-------------------------
+Tolino firmware 14 made the request, version 15.2.0 was available.
+
+Key ``update`` is ``2``.
+
+.. include:: pageplace.bosh-bosh-rest-v2-versioncheck.response-update.json
+ :code:
+
+
+Example: No update available
+----------------------------
+Key ``update`` is ``0``.
+
+.. include:: pageplace.bosh-bosh-rest-v2-versioncheck.response-noupdate.json
+ :code: