Zum Hauptinhalt springen

[Order Intake - GCW] So nutzen Sie die kundenunabhängigen Order-API-Endpunkte

S
Verfasst von Styrbjörn Holmberg
Vor über 3 Wochen aktualisiert

Sie können mit den API-Endpunkten alle Kundenbestellungen abrufen und durchsuchen – nicht nur die eines bestimmten Kunden. So funktioniert es:

1. Erstellen Sie einen Connector

  1. Gehen Sie zu Order Intake → Connectors.

  2. Erstellen Sie einen neuen Connector.

  3. Wählen Sie API Connector aus.

  4. Wählen Sie Alle Kunden aus.

  5. Geben Sie ihm einen Namen, zum Beispiel Customer-Agnostic Connector.

  6. Kopieren Sie Ihren X-API-KEY.

  7. Klicken Sie auf Erstellen.

Jetzt sind Ihre Endpunkte einsatzbereit.


2. Richten Sie Ihre API-Anfragen ein

A. Eine Einzelfäden-Bestellung erhalten

  • Methode:GET

  • Endpunkt: Verwenden Sie den Get Order-Endpunkt Ihres Connectors.

  • Überschriften:

    • X-API-KEY: [Ihr kopierter Schlüssel]

  • Text: Nicht erforderlich.

  • Schritte:

    1. Ersetzen Sie die {orderId} in der URL durch eine echte Bestellnummer.

    2. Klicken Sie auf Senden.

    3. Sie erhalten die Bestelldetails.

B. Mehrere Bestellungen suchen

  • Methode:POST

  • Endpunkt: Verwenden Sie den Search Orders-Endpunkt aus Ihrem Connector.

  • Überschriften:

    • X-API-Key: [Ihr kopierter Schlüssel]

  • Text: Geben Sie Ihre Suchfilter im JSON-Format an.

Schritte:

  1. Fügen Sie den Such-Endpunkt ein.

  2. Stellen Sie die Methode auf POST ein.

  3. Fügen Sie den JSON-Textkörper hinzu.

  4. Klicken Sie auf Senden.

  5. Sie erhalten eine Liste mit passenden Bestellungen.


Typische Fehler, die Sie vermeiden sollten

  • Falsche Methode:GET für eine Einzelfäden-Bestellung, POST für die Suche.

  • Kein API-Schlüssel: Geben Sie Ihren X-API-KEY immer im Header an.

  • Fehlender Suchinhalt: Für die Suche benötigen Sie einen JSON-Body mit Ihren Filtern.

Hat dies deine Frage beantwortet?