Como aponto um cliente ShipsGo v2 para o Dockflow sem reescrevê-lo?

Perguntas e respostas de instruções
1

Tenho um cliente feito para a API marítima ShipsGo v2. Ele consegue rodar no Dockflow com os mesmos caminhos e corpos?

Sim. Altere dois valores:

  1. Defina a URL base como https://api.dockflow.com/compat/shipsgo/v2
  2. Coloque uma chave de API do Dockflow em X-Shipsgo-User-Token. Crie a chave no Console da API com o escopo Downstream.

Um exemplo prático, com um token fictício. Crie um embarque:

POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN

{"reference":"PO-5521","booking_number":"BK-7741"}

A resposta contém o id do embarque. Consulte-o de volta com esse id. Esta resposta está resumida:

GET /compat/shipsgo/v2/ocean/shipments/74123

{"message":"SUCCESS","shipment":{"id":74123,
 "reference":"PO-5521","booking_number":"BK-7741",
 "status":"BOOKED"}}

Três coisas são diferentes. Filtros de listagem além de id e número de contêiner são recusados, seguidores e tags ficam vazios, e rotas aéreas não são cobertas. A lista é ordenada pela última alteração, da mais antiga para a mais recente, e qualquer order_by é recusado. Até a importação ser executada, uma leitura mostra apenas o número que você enviou. Os destinos de webhook são adicionados pelo suporte do Dockflow, e cada entrega carrega o X-Shipsgo-Webhook-Signature.

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