First part of the setup process
[tolino-api-docs.git] / api / identifiers.rst
1 ===========
2 Identifiers
3 ===========
4
5 Publication ID
6 ==============
7 A book has an identifier, for example ``DT0400.9783641267575_A39529579``.
8
9 The API uses ``publicationId`` and ``pubid`` as names.
10
11 It consists of several parts:
12
13 - Prefix ``DT``
14 - four-letter order ID ``0400``
15 - ISBN-13 ``9783641267575``
16 - unknown suffix ``A39529579``
17
18
19 Excerpt from `Analyse verbreiteter Anwendungen zum Lesen von elektronischen Büchern <https://opus4.kobv.de/opus4-fau/frontdoor/index/index/docId/12551>`_:
20
21  Der Aufbau des Wertes der Variable ``path`` erläutern wir anhand eines Beispiels:
22
23  ``/publications/DT<BESTELLUNG>.<ISBN-13>/bookmark/<VAR>``
24
25  Hierbei handelt es sich bei BESTELLUNG um eine vierstellige Zahl,
26  welche bei allen Büchern, die innerhalb des selben Bestellvorgangs gekauft
27  wurden, identisch ist.
28  Dies wurde mit mehreren Bestellungen von fünf, drei bzw. einem Buch nachvollzogen.