Headless API Integration

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

Zeigen Sie passende Produktempfehlungen — im Checkout, im Warenkorb, auf der Produktdetailseite oder in jeder E-Mail.

Fulfilment

Integrieren Sie 35up entlang der gesamten Wertschöpfungskette vollständig in Ihr System — von der Bestellung bis zum Retourenprozess.

Volle Kontrolle

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

KI-Matching

Sie müssen passende Produkte nicht manuell zuordnen und benötigen keine passende Datenbank — 35up erkennt Ihre Produkte automatisch.

Lassen Sie uns loslegen

Die relevantesten Endpunkte werden im Folgenden beschrieben. Um sich ein vollständiges Bild zu machen, besuchen Sie unsere API-Referenz.
GET
Recommendations
POST
Orders
POST
Returns
curl --request GET \  --url 'https://api.35up.io/v1/recommendations?baseProduct.title=iPhone%2013&seller=test&session=test'

Request

Der Endpunkt „Get Recommendations“, ein leistungsstarkes Tool, mit dem Shops Produktempfehlungen auf der Grundlage des angegebenen „BaseProduct.Title“ abrufen können.

  • partner: Mit diesem Parameter können wir den Partner oder Kunden identifizieren, der auf die API zugreift. Durch die Angabe der eindeutigen Kennung des Partners können wir sichere und personalisierte Interaktionen mit unserer Plattform gewährleisten.
  • session: Der Parameter „session“ hilft bei der Verfolgung und Verwaltung von Benutzersitzungen und gewährleistet so ein nahtloses Erlebnis bei Interaktionen mit der API. Er wird verwendet, um den Kontext aufrechtzuerhalten und benutzerspezifische Informationen zu speichern.
  • 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 den Umfang der abgerufenen Empfehlungen an die Anforderungen Ihrer Anwendung anpassen.
  • lang: Mit dem Parameter „lang“ können Sie die bevorzugte Sprache für die API-Antwort definieren. Indem Sie den entsprechenden Sprachcode (z. B. „de“ für Deutsch) angeben, können Sie sicherstellen, dass die Empfehlungen in der gewünschten Sprache präsentiert werden.
  • country: Dieser Parameter hilft bei der Anpassung der Produktempfehlungen an bestimmte geografische Regionen. Durch Angabe des entsprechenden Ländercodes (z. B. „de“ für Deutschland) gibt die API Empfehlungen zurück, die für Benutzer in diesem bestimmten Land relevanter sind.
  • baseProduct.title: Der „BaseProduct.title“ ist ein entscheidender Parameter, der das Produkt angibt, für das Sie Empfehlungen erhalten möchten. Es wird automatisch erkannt und muss nicht abgeglichen 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, das allgemeine Einkaufserlebnis auf Ihrer Plattform zu verbessern und den Umsatz zu steigern.

‍

Response

Als Antwort darauf wird eine Liste mit passenden formatierten Produkten bereitgestellt, die bereits alle Admin-Einstellungen berücksichtigt. Die Antwort kann angezeigt werden, ohne dass eine weitere Backend-Filterung erforderlich ist.

  • recommendations: Dies ist ein Array, das die Liste der empfohlenen Produkte enthält, die auf der Eingabe „BaseProduct.Title“ basieren. Jedes Element im Array steht für ein empfohlenes Produkt mit den zugehörigen Details.
  • sku: Die SKU (Stock Keeping Unit) ist eine eindeutige Kennzeichnung für das empfohlene Produkt. Sie hilft dabei, das Produkt von anderen zu unterscheiden, und wird verwendet, um eine Bestellung aufzugeben.
  • vendor: 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 Logos des Anbieters im Quadrat- und Querformat enthalten.
  • name: Der Name des empfohlenen Produkts, das dem Endkunden direkt angezeigt werden kann.
  • images: Dieses Objekt enthält URLs zum Vorschaubild des Produkts, sodass es praktisch ist, Produktbilder im Frontend anzuzeigen.
  • description: Hier bieten die Felder „short“ und „long“ eine kurze und detaillierte Beschreibung des empfohlenen Produkts.
  • price: Dieses Objekt beinhaltet die Preisdetails des empfohlenen Produkts. Es besteht aus „value“ (numerischer Preis), „currecny“ (die Währung, in der der Preis dargestellt wird, in diesem Fall „EUR“ für Euro) und „formatted“ (formatierter Preis für die Anzeige, z. B. „17,99€“).
  • specs: Gibt den Typ des Produkts an, z. B. ob es sich um ein „physisches“ Produkt oder eine „Versicherung“ handelt.
  • delivery: Dieses Objekt gibt Auskunft über die geschätzte Lieferzeit für das empfohlene Produkt. Es beinhaltet „TimeMin“ (Mindestlieferzeit) und „TimeMax“ (maximale Lieferzeit) in Tagen.
  • category: Dieses Feld steht für die Produktkategorien, zu denen das empfohlene Produkt gehört.

Durch die Analyse dieser JSON-Antwort können Shops diese Produktdetails extrahieren und anzeigen, sodass Benutzer die empfohlenen Produkte nahtlos erkunden und kaufen können.

‍

curl --request POST\
--url https://api.35up.io/v1/orders\
--header 'Autorisierung: Basic Base64 (Benutzer:pw) '\
--header 'Inhaltstyp: Anwendung/JSON'\
--daten '{
„Sitzung“: "“,
„status“: „genehmigt“,
„reference“: „onboardingOrderReference1",
„Kunde“: {
„firstName“: „Vorname des Testbenutzers“,
„lastName“: „Nachname des Testbenutzers“,
„email“:“ contact@35up.com „,
„Telefon“ :"+1123123123"
},
„Lieferadresse“: {
„FirstName“: „Vorname des Versandbenutzers“,
„lastName“: „Nachname des Versandbenutzers“,
„email“:“ shipping@35up.com „,
„street“: „Adalbertstraße“,
„StreetNumber“: „8",
„company“ :"35up GmbH“,
„extra“: „Hinterhaus“,
„PLZ“ :"10999",
„Stadt“: „Berlin“,
„Land“ :"DE“
},
„Artikel“: [
{
„sku“: „35UP004PANZF0000105",
„Menge“: 1
}
]
} '

Anfrage

Der Endpunkt „Bestellungen aufgeben“ verschiebt deine Shop-Bestellung auf 35up.

‍

Überschriften
  • Autorisierung: Die API-Anfrage verwendet die Standardauthentifizierung mit einem Base64-kodierten Token „sellerId:Password“. Beachten Sie, dass dieses Token aus Sicherheitsgründen gekürzt wurde und in einer echten Anfrage die entsprechenden Anmeldeinformationen für die Authentifizierung enthalten würde.
  • Inhaltstyp: Der als „application/json“ angegebene Inhaltstyp gibt an, dass die im Anforderungstext gesendeten Daten im JSON-Format vorliegen.
Text anfordern

‍

Die Daten, die im Anforderungstext 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 aufrechtzuerhalten.
  • Status: Zeigt den Status der Bestellung an. Es kann auf „genehmigt“ gesetzt werden, um die Bestellung direkt bei der Erstellung zu genehmigen.
  • referenzieren: Die Referenz-ID des Shops, um die Bestellung zu identifizieren und einfacher mit den anderen Shop-Bestellungen zu verbinden.
  • Kundin: Dieses Objekt enthält Angaben zum Kunden, der die Bestellung aufgibt. Es umfasst den „Vorname“, den „Nachnamen“, die „E-Mail“ und die „Telefonnummer“ des Kunden.
  • Lieferadresse: Gibt die Lieferadresse für die Lieferung der Bestellung an. Es enthält Felder wie „Vorname“, „Nachname“, „E-Mail“, „Straße“, „StreetNumber“, „Firma“, „Extra“ (zusätzliche Adressdetails wie Wohnungsnummer oder Gebäudename), „Postleitzahl“, „Stadt“ und „Land“.
  • Artikel: Ein Array von Objekten, die die Artikel in der Bestellung darstellen. Jeder Artikel enthält die „SKU“ (Stock Keeping Unit) und die „Menge“ (Menge) des bestellten Produkts.

Durch Senden dieser POST-Anfrage an den angegebenen Endpunkt mit dem entsprechenden Authentifizierungstoken, Inhaltstyp und Anforderungstext verarbeitet die API die Bestellung mit den bereitgestellten Informationen und erstellt eine genehmigte Bestellung, die dem Kunden und der in der Anfrage angegebenen Lieferadresse zugeordnet ist.

Antwort

  1. Erstellt am: Dieses Feld gibt den Zeitstempel an, zu dem die Bestellung erstellt wurde. Der Wert stellt einen Unix-Zeitstempel dar, der die Anzahl der Sekunden darstellt, die seit dem 1. Januar 1970 (UTC) vergangen sind. Er wird verwendet, um den genauen Zeitpunkt aufzuzeichnen, zu dem die Bestellung ursprünglich erstellt wurde.
  2. id: Das Feld „id“ ist eine eindeutige Kennung, die der Bestellung vom System zugewiesen wird. Es ist eine Zeichenfolge, die diese bestimmte Bestellung eindeutig identifiziert.
  3. Status: Dieses Feld steht für den Status der Bestellung und kann „genehmigt“, „ausstehend“ oder „storniert“ sein. Der Status „genehmigt“ zeigt an, dass die Bestellung erfolgreich bearbeitet und akzeptiert wurde.
  4. aktualisiert am: Ähnlich wie das Feld „createdAt“ bietet „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 nachzuverfolgen.

Nach einer erfolgreichen POST-Anfrage an den API-Endpunkt mit den erforderlichen Bestelldetails gibt die Antwort dieses JSON-Objekt mit den oben genannten Feldern zurück. Die Antwort enthält wichtige Informationen wie die Bestellnummer, Zeitstempel für Erstellung und Aktualisierung sowie den aktuellen Status der Bestellung („genehmigt“). Diese Daten können für Aufzeichnungen, Auftragsverfolgung und Synchronisation mit den Backend-Systemen des Shops oder Unternehmens verwendet werden.

‍

curl --request POST\
--url https://api.35up.io/v1/returns/\
--header 'Autorisierung: Basic Base64 (Benutzer:pw) '\
--header 'Inhaltstyp: Anwendung/JSON'\
--daten '{
„Bestell-ID“: „2c66b9100d2141eeaa7cfce73df8de36",
„Artikel“: [
{
„sku“: „35UP004C5BLF0000037",
„Menge“: 1
}
]
} '

Anfrage

Überschriften
  • Autorisierung: Die API-Anfrage verwendet die Standardauthentifizierung mit einem Base64-kodierten Token „sellerId:Password“. Beachten Sie, dass dieses Token aus Sicherheitsgründen gekürzt wurde und in einer echten Anfrage die entsprechenden Anmeldeinformationen für die Authentifizierung enthalten würde.
  • Inhaltstyp: Der Header „Content-Type“ gibt an, dass die im Anforderungstext gesendeten Daten im JSON-Format vorliegen. Der Wert „application/json“ gibt den JSON-Inhaltstyp an.
Text anfordern

‍

Die Daten, die im Anforderungstext gesendet werden, sind ein JSON-Objekt mit den folgenden Feldern:

  • ID der Bestellung: Das Feld „OrderID“ enthält die eindeutige Kennung der ursprünglichen Bestellung, für die die Rücksendung beantragt wird.
  • Artikel: Dieses Feld ist ein Array von Objekten, die die zurückzugebenden Elemente darstellen. Jeder Artikel im Array enthält die „SKU“ (Stock Keeping Unit) des Produkts, das zurückgegeben wird, und die „Menge“ (Menge) dieses bestimmten Artikels, der zurückgegeben werden soll.

Durch Senden dieser POST-Anfrage an den angegebenen Endpunkt mit dem entsprechenden Authentifizierungstoken, Inhaltstyp und Anforderungstext verarbeitet die API die Rücksendeanforderung und leitet den Rückgabevorgang für die angegebenen Produkte ein, die der angegebenen Bestellnummer zugeordnet sind. Die API-Antwort wird Informationen zur Rücksendung enthalten, darunter eine Rücksendebestätigungs-ID, Zeitstempel oder andere relevante Details.

‍

‍

Antwort

  • Erstellt am: Dieses Feld gibt den Zeitstempel an, zu dem die Rückgabe erstellt wurde. Der Wert ist ein Unix-Zeitstempel, der die Anzahl der Sekunden darstellt, die seit dem 1. Januar 1970 (UTC) vergangen sind. Es gibt den genauen Zeitpunkt an, zu dem die Rückgabeanforderung generiert wurde.
  • id: Das Feld „id“ ist eine eindeutige Kennung, die der Rückgabe vom System zugewiesen wird. Es ist eine Zeichenfolge, die diese spezifische Rücksendeanforderung eindeutig identifiziert.
  • Artikel: Dieses Array enthält Objekte, die die zurückgegebenen Elemente 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.
  • ID der Bestellung: Das Feld „OrderID“ enthält die eindeutige Kennung der ursprünglichen Bestellung, die mit der Rücksendung verknüpft ist. Es verknüpft den Rücksendeantrag mit der spezifischen Bestellung, von der der Kunde Artikel zurücksendet.
  • Verkäufer-ID: Dieses Feld gibt die ID des Verkäufers an, der den Rückgabevorgang abwickelt. Es hilft bei der Identifizierung der für die Verwaltung der Rücksendung verantwortlichen Partei.
  • Status: Das Feld „Status“ stellt den aktuellen Status des Rücksendeantrags dar. In diesem Beispiel lautet der Status „erstellt“, was darauf hinweist, dass die Rücksendeanforderung generiert wurde und auf die weitere Bearbeitung wartet.
  • aktualisiert am: Ähnlich wie das Feld „createdAt“ bietet „updatedAt“ einen Unix-Zeitstempel, der angibt, wann der Status oder die Informationen der Rücksendeanforderung das letzte Mal 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.
  • Anbieter-ID: Das Feld „VendorID“ stellt die eindeutige Kennung des Anbieters oder Verkäufers dar, bei dem der Kunde das zurückgegebene Produkt gekauft hat.

Wenn Sie eine Rücksendeanforderung über die API stellen, enthält die Antwort dieses JSON-Objekt mit den relevanten Informationen zur Rückgabe. Die in der Antwort bereitgestellten Daten helfen dem Geschäft oder Unternehmen dabei, den Rückgabeprozess zu verwalten, die Rücksendedetails im Auge zu behalten und dem Kunden Rücksendeinformationen mitzuteilen.

‍

‍