Kopflose Integration mit unserer API

Nutzen Sie unsere leistungsstarke REST-API für volle Flexibilität - headless und einfach zu bedienen.
curl --request GET \ --url 'https://api.35up.io/v1/recommendations?baseProduct.title=iPhone%2013&seller=test&session=test'

{
 "recommendations": [
   {
     "vendor": {
       "name": "caseable",
       "logo": {
         "square": "https://static.35up.io/vendors/caseable/logo/square.png",
         "landscape": "https://static.35up.io/vendors/caseable/logo/landscape.png"
       },
       "legalName": "caseable GmbH",
       "id": "caseable"
     },
     "specs": {
       "type": "physical"
     },
     "sku": "35UP004C5BLF70407C9",
     "price": {
       "value": 16.99,
       "formatted": "€ 16,99",
       "currency": "EUR"
     },
     "name": "Silikon Handyhülle schwarz",
     "images": {
       "thumbnail": "https://static.35up.io/products/caseable/2023/07/20/3482928d-0103-47d6-833f-9492599f25a4.png?session=test"
     },
     "descriptions": {
       "short": "Passend für: Apple iPhone 13 Das strapazierfähige Silikon macht diese Handyhülle zum flexiblen Schutz für dein Smartphone. Die Hülle umschließt dein Gerät für einen guten Sitz maximalen Stoßschutz und kann einfach Auf- und Abgezogen werden.",
       "long": "Passend für: Apple iPhone 13 Das strapazierfähige Silikon macht diese Handyhülle zum flexiblen Schutz für dein Smartphone. Die Hülle umschließt dein Gerät für einen guten Sitz maximalen Stoßschutz und kann einfach Auf- und Abgezogen werden."
     },
     "delivery": {
       "timeMin": 1,
       "timeMax": 7
     },
     "categories": [],
     "availability": true
   }
 ]
}

Empfehlungen

Holen Sie sich passende Empfehlungen, wo immer Sie wollen - im Checkout, im Warenkorb, auf der Produktdetailseite oder in einer E-Mail.

Fulfilment

Integrieren Sie 35up vollständig in Ihr System entlang der gesamten Wertschöpfungskette - vom Bestell- bis zum Retourenprozess.

Volle Kontrolle

Steuern Sie alles über den 35up Admin und erhalten Sie vorformatierte Daten - Sie müssen keine Produkte filtern oder Preise selbst festlegen.

AI matching

Sie müssen die passenden Produkte nicht manuell abgleichen und brauchen auch keine passende DB - 35up erkennt Ihre Produkte automatisch.

Fangen wir an

Die wichtigsten Endpunkte werden im Folgenden beschrieben. Um ein vollständiges Bild zu erhalten, besuchen Sie unsere API-Referenz.
GET
Empfehlungen
POST
Bestellungen
POST
Rückgabe
curl --request GET \ --url 'https://api.35up.io/v1/recommendations?baseProduct.title=iPhone%2013&seller=test&session=test'

Anfrage

Der "Get Recommendations"-Endpunkt, ein leistungsstarkes Tool, mit dem Shops Produktempfehlungen auf der Grundlage des angegebenen "baseProduct.title" abrufen können.

  • Partner: Dieser Parameter ermöglicht es uns, den Partner oder Kunden zu identifizieren, der auf die API zugreift. Durch die Einbeziehung der eindeutigen Kennung des Partners können wir sichere und personalisierte Interaktionen mit unserer Plattform gewährleisten.
  • Sitzung: Der "Session"-Parameter hilft bei der Verfolgung und Verwaltung von Benutzersitzungen und gewährleistet eine nahtlose Erfahrung bei Interaktionen mit der API. Er wird verwendet, um den Kontext zu erhalten und benutzerspezifische Informationen zu bewahren.
  • limit: Mit dem Parameter "limit" können Sie die maximale Anzahl von Produktempfehlungen angeben, die in der API-Antwort zurückgegeben werden sollen. Auf diese Weise können Sie die Menge der abgerufenen Empfehlungen an die Bedürfnisse Ihrer Anwendung anpassen.
  • lang: Mit dem Parameter "lang" kannst du die bevorzugte Sprache für die API-Antwort festlegen. Durch Übergabe des entsprechenden Sprachcodes (z. B. "de" für Deutsch) kannst du sicherstellen, dass die Empfehlungen in der gewünschten Sprache angezeigt werden.
  • Land: Dieser Parameter hilft bei der Anpassung der Produktempfehlungen an bestimmte geografische Regionen. Durch die Angabe des entsprechenden Ländercodes (z. B. "de" für Deutschland) gibt die API Empfehlungen zurück, die für Nutzer in diesem bestimmten Land relevanter sind.
  • baseProduct.title: Der "baseProduct.title" ist ein wichtiger Parameter, der das Produkt angibt, für das Sie Empfehlungen erhalten möchten. Er wird automatisch erkannt und muss nicht angepasst werden.

Durch die effektive Nutzung dieser Parameter kann Ihr Shop den Endpunkt "Get Recommendations" nutzen, um Ihren Nutzern personalisierte und relevante Produktvorschläge zu unterbreiten, die das Einkaufserlebnis auf Ihrer Plattform insgesamt verbessern und den Umsatz steigern.

‍

Antwort

Als Antwort wird eine Liste mit formatierten, passenden Produkten geliefert, die bereits alle Verwaltungseinstellungen berücksichtigt. Die Antwort kann angezeigt werden, ohne dass eine weitere Filterung im Backend erforderlich ist.

  • Empfehlungen: Dies ist ein Array, das die Liste der empfohlenen Produkte auf der Grundlage der Eingabe "baseProduct.title" enthält. Jedes Element in dem Array stellt ein empfohlenes Produkt mit den zugehörigen Details dar.
  • sku: Die SKU (Stock Keeping Unit) ist ein eindeutiger Identifikator für das empfohlene Produkt. Sie hilft dabei, das Produkt von anderen zu unterscheiden und wird für die Bestellung verwendet.
  • Hersteller: Dieses Objekt enthält Informationen über den Anbieter des empfohlenen Produkts. Es enthält Felder wie "id", "name", "legalName" und "logo", die URLs zu den quadratischen und querformatigen Logos des Anbieters enthalten.
  • Name: Der Name des empfohlenen Produkts, der dem Endkunden direkt angezeigt werden kann.
  • Bilder: Dieses Objekt enthält URLs zu den Miniaturbildern des Produkts, die sich für die Anzeige von Produktbildern im Frontend eignen.
  • Beschreibungen: Die Felder "kurz" und "lang" enthalten jeweils eine kurze und eine ausführliche Beschreibung des empfohlenen Produkts.
  • Preis: Dieses Objekt enthält die Preisangaben für das empfohlene Produkt. Es besteht aus "Wert" (numerischer Preis), "Währung" (die Währung, in der der Preis dargestellt wird, in diesem Fall "EUR" für Euro) und "formatiert" (formatierter Preis für die Anzeige, z. B. "€ 17,99").
  • Spezifizierungen: Gibt die Art des Produkts an, z. B. ob es sich um eine "physische" oder eine "Versicherung" handelt.
  • Lieferung: Dieses Objekt gibt Auskunft über die voraussichtliche Lieferzeit für das empfohlene Produkt. Es enthält "timeMin" (Mindestlieferzeit) und "timeMax" (Höchstlieferzeit) in Tagen.
  • Kategorien: In diesem Feld werden die Produktkategorien angegeben, zu denen das empfohlene Produkt gehört.

Durch das Parsen dieser JSON-Antwort können die Shops diese Produktdetails extrahieren und anzeigen, so dass die Nutzer die empfohlenen Produkte nahtlos erkunden und kaufen können.

‍

curl --request POST \
 --url https://api.35up.io/v1/orders \
 --header 'Authorization: Basic base64(user:pw)' \
 --header 'content-type: application/json' \
 --data '{
 "session":"",
 "status":"approved",
 "reference": "OnboardingOrderReference1",
  "customer":{
     "firstName":"TestUser Firstname",
     "lastName":"TestUser Lastname",
     "email":"contact@35up.com",
     "phone":"+1123123123"
  },
  "shippingAddress":{
     "firstName":"ShippingUser Firstname",
     "lastName":"ShippingUser Lastname",
     "email":"shipping@35up.com",
     "street":"Adalbertstrasse",
     "streetNumber":"8",
     "company":"35up GmbH",
     "extra":"Hinterhaus",
     "postcode":"10999",
     "city":"Berlin",
     "country":"DE"
  },
  "items":[
     {
       "sku":"35UP004PANZF0000105",
       "qty" : 1
     }
  ]
}'

Anfrage

Der Endpunkt "Post Orders" überträgt Ihre Shop-Bestellung an 35up.

‍

Kopfzeilen
  • Autorisierung: Die API-Anforderung verwendet die Basisauthentifizierung mit einem base64-kodierten Token "sellerId:password". Beachten Sie, dass dieses Token aus Sicherheitsgründen gekürzt wurde und bei einer echten Anfrage die entsprechenden Anmeldedaten für die Authentifizierung enthalten würde.
  • Inhaltstyp: Der als "application/json" angegebene Inhaltstyp zeigt an, dass die im Anfragekörper gesendeten Daten im JSON-Format sind.
Anfrage Körper

‍

Die Daten, die im Körper der Anfrage gesendet werden, sind ein JSON-Objekt mit den folgenden Feldern:

  • Sitzung: Stellt eine Sitzungskennung dar, die verwendet werden kann, um die Kontinuität oder den Kontext während des Bestellvorgangs zu erhalten.
  • Status: Gibt den Status des Auftrags an. Er kann auf "genehmigt" gesetzt werden, um den Auftrag direkt bei der Erstellung zu genehmigen.
  • Referenz: Die Referenz-ID des Shops, um die Bestellung zu identifizieren und leichter mit den anderen Bestellungen des Shops zu verbinden.
  • Kunde: Dieses Objekt enthält Einzelheiten über den Kunden, der die Bestellung aufgibt. Es enthält den "Vornamen", den "Nachnamen", die "E-Mail" und die "Telefonnummer" des Kunden.
  • shippingAddress: Liefert die Details der Lieferadresse für die Zustellung der Bestellung. Sie umfasst Felder wie "Vorname", "Nachname", "E-Mail", "Straße", "Straßennummer", "Unternehmen", "extra" (zusätzliche Adressangaben wie Wohnungsnummer oder Gebäudename), "Postleitzahl", "Ort" und "Land".
  • Artikel: Ein Array von Objekten, die die Artikel in der Bestellung darstellen. Jeder Artikel enthält die "sku" (Stock Keeping Unit) und "qty" (Menge) des bestellten Produkts.

Durch Senden dieser POST-Anfrage an den angegebenen Endpunkt mit dem entsprechenden Authentifizierungs-Token, Inhaltstyp und Anfragetyp verarbeitet die API die Bestellung mit den bereitgestellten Informationen und erstellt eine genehmigte Bestellung, die mit dem Kunden und der in der Anfrage angegebenen Lieferadresse verknüpft ist.

Antwort

  1. erstelltAt: Dieses Feld gibt den Zeitstempel an, an dem der Auftrag erstellt wurde. Der Wert stellt einen Unix-Zeitstempel dar, der die Anzahl der seit dem 1. Januar 1970 (UTC) verstrichenen Sekunden angibt. Er wird verwendet, um die genaue Zeit zu erfassen, zu der der Auftrag ursprünglich erstellt wurde.
  2. id: Das Feld "id" ist ein eindeutiger Bezeichner, der dem Auftrag vom System zugewiesen wird. Es handelt sich um eine Zeichenkette, die diesen speziellen Auftrag eindeutig identifiziert.
  3. Status: Dieses Feld gibt den Status der Bestellung an, der "genehmigt", "ausstehend" oder "storniert" sein kann. Der Status "genehmigt" bedeutet, dass der Auftrag erfolgreich bearbeitet und angenommen wurde.
  4. updatedAt: Ähnlich wie das Feld "createdAt" liefert "updatedAt" einen Unix-Zeitstempel, der angibt, wann der Status oder die Informationen der Bestellung zuletzt aktualisiert wurden. Dieser Zeitstempel ist nützlich, um die letzten Änderungen an der Bestellung zu verfolgen.

Nach einer erfolgreichen POST-Anfrage an den API-Endpunkt mit den erforderlichen Auftragsdetails gibt die Antwort dieses JSON-Objekt mit den oben genannten Feldern zurück. Die Antwort enthält wichtige Informationen wie die Bestell-ID, den Erstellungs- und Aktualisierungszeitstempel und den aktuellen Status der Bestellung ("genehmigt"). Diese Daten können für die Aufzeichnung, die Auftragsverfolgung und die Synchronisierung mit den Backend-Systemen des Shops oder Unternehmens verwendet werden.

‍

curl --request POST \
 --url https://api.35up.io/v1/returns/ \
 --header 'Authorization: Basic base64(user:pw)' \
 --header 'Content-Type: application/json' \
 --data '{
 "orderId": "2c66b9100d2141eeaa7cfce73df8de36",
 "items": [
   {
     "sku": "35UP004C5BLF0000037",
     "qty": 1
   }
 ]
}'

Anfrage

Kopfzeilen
  • Autorisierung: Die API-Anforderung verwendet die Basisauthentifizierung mit einem base64-kodierten Token "sellerId:password". Beachten Sie, dass dieses Token aus Sicherheitsgründen gekürzt wurde und bei einer echten Anfrage die entsprechenden Anmeldedaten für die Authentifizierung enthalten würde.
  • Inhalt-Typ: Die Kopfzeile "Content-Type" gibt an, dass die Daten, die im Body der Anfrage gesendet werden, im JSON-Format vorliegen. Der Wert "application/json" gibt den JSON-Inhaltstyp an.
Anfrage Körper

‍

Die Daten, die im Körper der Anfrage gesendet werden, sind ein JSON-Objekt mit den folgenden Feldern:

  • orderId: Das Feld "orderId" enthält die eindeutige Kennung der ursprünglichen Bestellung, für die die Rückgabe angefordert wird.
  • Elemente: Dieses Feld ist ein Array von Objekten, die die zurückzugebenden Artikel darstellen. Jedes Element in dem Array enthält die "sku" (Stock Keeping Unit) des zurückgegebenen Produkts und die "qty" (Menge) dieses spezifischen zurückzugebenden Elements.

Durch Senden dieser POST-Anfrage an den angegebenen Endpunkt mit dem entsprechenden Authentifizierungs-Token, Inhaltstyp und Anfragetyp verarbeitet die API die Rückgabeanforderung und leitet den Rückgabeprozess für das/die angegebene(n) Produkt(e) ein, das/die mit der angegebenen Bestell-ID verbunden ist/sind. Die API-Antwort enthält Informationen zur Rücksendung, z. B. eine Rücksendebestätigungs-ID, Zeitstempel oder andere relevante Details.

‍

‍

Antwort

  • erstelltAt: Dieses Feld gibt den Zeitstempel an, an dem die Meldung erstellt wurde. Der Wert ist ein Unix-Zeitstempel, der die Anzahl der seit dem 1. Januar 1970 (UTC) verstrichenen Sekunden angibt. Er gibt den genauen Zeitpunkt an, zu dem die Rückgabeanforderung erstellt wurde.
  • id: Das Feld "id" ist ein eindeutiger Bezeichner, der der Rückgabe vom System zugewiesen wird. Es handelt sich um eine Zeichenfolge, die diese spezielle Rückgabeanforderung eindeutig identifiziert.
  • Elemente: Dieses Array enthält Objekte, die die zurückgegebenen Artikel darstellen. Jedes Objekt enthält eine "id" (eine eindeutige Kennung für den zurückgegebenen Artikel), "qty" (Menge), die die Anzahl der zurückgegebenen Einheiten darstellt, und "sku" (Stock Keeping Unit) des zurückgegebenen Produkts.
  • orderId: Das Feld "orderId" enthält die eindeutige Kennung der ursprünglichen Bestellung, die mit der Rückgabe verbunden ist. Es verknüpft die Rückgabeanfrage mit der spezifischen Bestellung, von der der Kunde Artikel zurückgibt.
  • VerkäuferId: In diesem Feld wird die ID des Verkäufers angegeben, der die Rückgabe bearbeitet. Es hilft bei der Identifizierung der verantwortlichen Partei für die Verwaltung der Rückgabe.
  • Status: Das Feld "Status" gibt den aktuellen Status des Rückgabeantrags an. In diesem Beispiel ist der Status "erstellt", was bedeutet, dass der Rücksendeantrag erstellt wurde und auf die weitere Bearbeitung wartet.
  • updatedAt: Ähnlich wie das Feld "createdAt" liefert "updatedAt" einen Unix-Zeitstempel, der angibt, wann der Status oder die Informationen der Rückgabeanforderung zuletzt aktualisiert wurden.
  • urls: Dieses Objekt enthält URLs, die sich auf den Rückgabeprozess beziehen. Es enthält eine "returnSheet"-URL, die auf ein PDF-Dokument mit Rückgabedetails und Anweisungen verweist.
  • vendorId: Das Feld "vendorId" steht für die eindeutige Kennung des Anbieters oder Verkäufers, bei dem der Kunde das zurückgegebene Produkt gekauft hat.

Bei einer Rückgabeanfrage über die API enthält die Antwort dieses JSON-Objekt mit den relevanten Informationen über die Rückgabe. Die in der Antwort enthaltenen Daten helfen dem Shop oder Unternehmen, den Rückgabeprozess zu verwalten, die Rückgabedetails zu verfolgen und dem Kunden die Rückgabeinformationen mitzuteilen.

‍

‍