Come sposto un client di tracciamento project44 v4 su Dockflow cambiando solo l'URL e il secret?

Domande e risposte pratiche
1

Il mio cliente utilizza lo scambio di token e le route di tracking di project44 v4. Cosa deve cambiare?

Due valori:

  1. Imposta l’URL di base su https://api.dockflow.com/compat/project44
  2. Usa una chiave API di Dockflow come client secret. Crea la chiave nella API Console con lo scope Downstream.

Un caso concreto, con un secret fittizio. Lo scambio restituisce il secret come 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}

Avvia il tracking. Questa risposta è abbreviata:

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

Gli stessi identificatori raggiungono sempre la stessa spedizione. Ogni container riceve anche il proprio id figlio, che funziona sulle route di lettura ed eliminazione. Un tipo di identificatore al di fuori dell’elenco pubblicato risponde con 400.

Lettura tramite quell’id. Posizioni, costi e contenuti restano vuoti. Le route dei webhook rispondono con 403, quindi il supporto di Dockflow aggiunge la tua destinazione. Ogni consegna contiene il corpo della lettura della cronologia e un header X-Dockflow-Signature.

Mappatura completa dei campi e verifica della firma: