Produkt

Dieses Dokument beschreibt die REST-Schnittstellen für Produktdaten.

Inhaltsverzeichnis

Schnittstellen

Abfragen für Produkt-Daten

Abfragen eines Produkt

Es kommen Informationen zu einem Produkt zurück.

Abfragen eines Produkt nach External ID

Abfragen der Produkten einer Destination

Abfragen der Produkte über einen Geocode

Es werden zuerst die Destinationen gesucht, deren Polygon den Geocode enthält. Zu diesen Destinationen werden dann die Produkte gesucht. Dabei werden die Produkte von lokalem Interesse bevorzugt ausgegeben, d.h. Produkte an Destinationen vom Typ AdminCity oder TravelRegion werden vor die Produkte von Destinationen der Typen AdminRegion, AdminCountry und AdminContinent sortiert. So liefert die Suche mit dem Geocode von Florenz die Produkte Flozenz und Toskana vor dem Produkt Italien, unabhängig von der gewählten Sortierung.

Wird der "geocode" Parameter weggelassen, so erfolgt eine Suche über alle Produkte. Dies beinhaltet auch Produkte, die aktuell keiner Destination zugeordnet sind.

Abfragen der Produkten Top-Sellers

Es wird nur die Top-Seller Produkten vom den aktuellen Customer zurückliefern.

Abfragen der Produkten auf Marken und Produkt-Type einschränken

Bei der Einschränkung nach Marken-Id und Produkt-Typ ist eine Mehrfachauswahl möglich. Die Werte werden durch Kommas voneinander getrennt. Beim Abfragen für Top-Sellers ist die Produkten schon nach aktuellen Customer Brand eingeschränkt, deswegen ist die Einschränkung in diesem Fall nur noch nach Produkt-Typ möglich.

Abfragen der Produkte auf Suchbegriffe einschränken

Gesucht wird im Titel sowie in den Tags der Produkte.

Abfragen der Produkte auf Autoren einschränken

Sortierung der Produkte

Bei der Produktsuche über Geocode werden die Produkte primär nach den zugeordneten Destination sortiert, d.h. Produkte über Städte oder Reiseziele haben immer Vorrang vor Produkten von Landesteilen oder Ländern. Die Sortierung nach Verkaufszahlen oder Preis ist in diesem Fall nur sekundär.

Alternatives Ausgabeformat mit Produktzusammenfassung (Stichwort "multiChannel")

Es gibt keine eigenständigen Produkte für eBooks oder Apps mehr, die Zuordnung über "multiChannel" ist entfallen. Der Filter "multiproduct" unterscheidet sich nicht mehr vom Filter "product" und das Element "children" wird nicht mehr unterstützt.

Als Ersatz für "children" wird jetzt das neue Boolean-Element "ebook" gesetzt, wenn ein Produkt auch als eBook verfügbar ist.

Übersicht der Marken und Produkttypen

Datenstruktur für Product

Wie üblich, wird ein Array von Produkten als Wert der "entries"-Eigenschaft der Globalen Response Datenstruktur gesetzt.

{
      "entries": <Object>[0..n]
      "totalResults": 28,
      "startIndex": 0,
      "itemsPerPage": 10,
      "searchTime": 206
    }

Beispiel

{
     "entries": [{
          "id": 18913,
          "externalId": "9783829725606",
          "title": "Norwegen MARCO POLO Reiseführer",
          "price": 11.99,
          "currency": "EUR",
          "description": "Entdecken Sie Norwegen mit all ... ist der Autor ein aufmerksamer und kritischer Beobachter geblieben. Für MARCO POLO schreibt er auch den Band #Oslo#.",
          "author": "Jens Uwe Kumpch Sprak & Tekst",
          "manufacturer": "Marco Polo",
          "isbn": "9783829725606",
          "productType": 1,
          "category": "Reiseführer > Europa",
          "imageUrl": "http://pic.123poi.com/api/content/images/image/0/5/o8/vg/t150/u/photo-9529324.jpg",
          "topSeller": false,
          "releaseDate": 1522533600000,
          "sales": 154,
          "brand": {
               "id": 3,
               "name": "MarcoPolo"
          },
          "productLinks": [{
              "url": "http://shop.marcopolo.de/9783829725606",
              "type": "PRODUCT_LINK",
              "brand": {
                   "id": 3,
                   "name": "MarcoPolo"
              }
          }],
          "destinationIds": [
               5691
          ],
          "tags": [{
               "id": 150775,
               "value": "Norwegen",
               "language": "de"
          }, {
               "id": 150636,
               "value": "Europa",
               "language": "de"
          }],
          "creationDate": 1418659429837,
          "lastUpdate": 1430794371098,
          "ebook": true
     },
     {
        ...
     }],
     "totalResults": 28,
     "startIndex": 0,
     "itemsPerPage": 10,
     "searchTime": 206
    }