Hoe verplaats ik een project44 v4-trackingclient naar Dockflow door alleen de URL en het secret te wijzigen?

Hoe-te Q&A
1

Mijn klant gebruikt de project44 v4 token exchange en tracking-routes. Wat moet er worden aangepast?

Twee waarden:

  1. Stel de basis-URL in op https://api.dockflow.com/compat/project44
  2. Gebruik een Dockflow API-sleutel als client secret. Maak de sleutel aan in de API Console met de Downstream-scope.

Een uitgewerkt voorbeeld, met een nep-secret. De exchange geeft het secret terug als het token:

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}

Start het tracken. Dit antwoord is ingekort:

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":[]}

Dezelfde identifiers komen altijd bij dezelfde zending uit. Elke container krijgt ook een eigen child-id, die werkt op de read- en delete-routes. Een identifiertype buiten de gepubliceerde lijst levert een 400 op.

Lees op basis van dat id. Posities, kosten en inhoud blijven leeg. De webhook-routes geven een 403, dus de Dockflow-support voegt jouw bestemming toe. Elke levering bevat de body van de history-read en een X-Dockflow-Signature-header.

Volledige veldmapping en de handtekeningcontrole: