Como movo um cliente de rastreamento project44 v4 para o Dockflow alterando apenas a URL e o secret?

Perguntas e respostas de instruções
1

Meu cliente usa o token exchange e as rotas de rastreamento do project44 v4. O que precisa mudar?

Dois valores:

  1. Defina a URL base como https://api.dockflow.com/compat/project44
  2. Use uma chave de API do Dockflow como client secret. Crie a chave no Console de API com o escopo Downstream.

Um exemplo prático, com um secret fictício. O exchange retorna o secret como 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}

Comece o rastreamento. Esta resposta está resumida:

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

Os mesmos identificadores sempre chegam ao mesmo shipment. Cada contêiner também recebe seu próprio child id, que funciona nas rotas de leitura e exclusão. Um tipo de identificador fora da lista publicada responde 400.

Leia por esse id. Posições, custos e conteúdos ficam vazios. As rotas de webhook respondem 403, então o suporte do Dockflow adiciona o seu destino. Cada entrega carrega o corpo da leitura de histórico e um cabeçalho X-Dockflow-Signature.

Mapeamento completo de campos e a verificação de assinatura: