Family sharing API doc
[tolino-api-docs.git] / api / pageplace.bosh-bosh-rest-content-xxx-yyy.rst
1 ===========================================================
2 ``GET https://bosh.pageplace.de/bosh/rest/content/xxx/yyy``
3 ===========================================================
4 Download a book from the cloud.
5
6 The URL is obtained from `GET https://bosh.pageplace.de/bosh/rest/cloud/downloadinfo`_.
7
8 Step 2 of the download process.
9
10
11 Request
12 =======
13
14 Header
15   Parts of the `bosh v1 header set`_:
16
17   ``hardware_id``
18
19   ``m_id``
20
21   ``t_auth_token``
22
23 Path parts
24   Example of a full path:
25   ``https://bosh.pageplace.de/bosh/rest/content/bf70563e-2d57-41a7-89d3-023f0c8cc650/MacBest+by+Pratchett+Terry.epub``
26
27   ``xxx``
28     Some kind of UUID.
29
30   ``yyy``
31     Human-readable file name
32
33
34 Response
35 ========
36 HTTP status code: ``200 OK``
37
38 ebook file content.
39
40
41 Error response: Header missing
42 ------------------------------
43 ``HTTP/1.1 400 Bad Request``
44
45 .. include:: pageplace.bosh-bosh-rest-content-xxx-yyy.response-missingheader.json
46    :code: