Wie verschiebe ich einen project44 v4 Tracking-Client zu Dockflow, indem ich nur die URL und das Secret ändere?

Anleitung F&A
1

Mein Kunde verwendet den Token-Austausch und die Tracking-Routen von project44 v4. Was muss geändert werden?

Zwei Werte:

  1. Setze die Basis-URL auf https://api.dockflow.com/compat/project44
  2. Verwende einen Dockflow-API-Schlüssel als Client-Secret. Erstelle den Schlüssel in der API Console mit dem Scope Downstream.

Ein durchgerechnetes Beispiel mit einem fiktiven Secret. Der Austausch gibt das Secret als Token zurück:

POST /compat/project44/api/v4/oauth2/token
grant_type=client_credentials&client_id=my-app&client_secret=prod_acme_FAKE-TOKEN

{"access_token":"prod_acme_FAKE-TOKEN","token_type":"BEARER","expires_in":3600}

Starte das Tracking. Diese Antwort ist gekürzt:

POST /compat/project44/api/v4/shipments/tracking
Authorization: Bearer prod_acme_FAKE-TOKEN

{"identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}]}

{"id":"00000000-0000-4000-8000-000000012345",
 "identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}],
 "problems":[]}

Dieselben Identifier führen immer zur selben Sendung. Jeder Container erhält außerdem eine eigene untergeordnete ID, die auf den Lese- und Löschrouten funktioniert. Ein Identifier-Typ außerhalb der veröffentlichten Liste antwortet mit 400.

Lies anhand dieser ID. Positionen, Kosten und Inhalte bleiben leer. Die Webhook-Routen antworten mit 403, daher fügt der Dockflow-Support dein Ziel hinzu. Jede Zustellung enthält den Body der History-Abfrage und einen X-Dockflow-Signature-Header.

Vollständige Feldzuordnung und die Signaturprüfung: