Wie richte ich einen ShipsGo v2-Client auf Dockflow aus, ohne ihn neu zu schreiben?

Anleitung F&A
1

Ich habe einen Client für die ShipsGo-v2-Ocean-API gebaut. Läuft er auf Dockflow mit denselben Pfaden und Bodies?

Ja. Ändere zwei Werte:

  1. Setze die Basis-URL auf https://api.dockflow.com/compat/shipsgo/v2
  2. Trage einen Dockflow-API-Schlüssel in X-Shipsgo-User-Token ein. Erstelle den Schlüssel in der API-Konsole mit dem Scope Downstream.

Ein durchgerechnetes Beispiel mit einem fiktiven Token. Eine Sendung anlegen:

POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN

{"reference":"PO-5521","booking_number":"BK-7741"}

Die Antwort enthält die Sendungs-ID. Lies die Sendung mit dieser ID wieder aus. Diese Antwort ist gekürzt:

GET /compat/shipsgo/v2/ocean/shipments/74123

{"message":"SUCCESS","shipment":{"id":74123,
 "reference":"PO-5521","booking_number":"BK-7741",
 "status":"BOOKED"}}

Drei Dinge unterscheiden sich. Listenfilter außer id und Containernummer werden abgelehnt, Follower und Tags bleiben leer, und Luftfrachtrouten werden nicht abgedeckt. Die Liste ist nach letzter Änderung sortiert, älteste zuerst, und jedes order_by wird abgelehnt. Bis der Import gelaufen ist, zeigt ein Lesezugriff nur die Nummer, die du gesendet hast. Webhook-Ziele werden vom Dockflow-Support hinzugefügt, und jede Zustellung trägt eine X-Shipsgo-Webhook-Signature.

Vollständige Feldzuordnung und die Signaturprüfung: