Comment migrer un client de suivi project44 v4 vers Dockflow en changeant uniquement l'URL et le secret ?

Tutoriel « Questions-Réponses »
1

Mon client utilise l’échange de jetons et les routes de suivi project44 v4. Que faut-il changer ?

Deux valeurs :

  1. Définissez l’URL de base sur https://api.dockflow.com/compat/project44
  2. Utilisez une clé API Dockflow comme secret client. Créez la clé dans la console API avec le scope Downstream.

Un exemple concret, avec un faux secret. L’échange renvoie le secret comme jeton :

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}

Lancez le suivi. Cette réponse est raccourcie :

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

Les mêmes identifiants aboutissent toujours à la même expédition. Chaque conteneur reçoit également son propre identifiant enfant, qui fonctionne sur les routes de lecture et de suppression. Un type d’identifiant hors de la liste publiée répond 400.

Lisez par cet id. Les positions, les coûts et le contenu restent vides. Les routes de webhook répondent 403, donc le support Dockflow ajoute votre destination. Chaque livraison contient le corps de la lecture d’historique et un en-tête X-Dockflow-Signature.

Mapping complet des champs et vérification de la signature :