Cargoes Flow istemcisini Dockflow'a nasıl geçirebilirim?

Nasıl yapılır Soru-Cevap
1

Müşterim Cargoes Flow takip API’sini çağırıyor. Dockflow üzerinde çalıştırmak için neyi değiştirmeliyim?

İki değer:

  1. Host’u değiştir. Kendi yolunu koruyan bir istemci https://api.dockflow.com/compat/cargoes-flow/flow/api/public_tracking/v1 adresini kullanabilir.
  2. X-DPW-ApiKey alanına bir Dockflow API anahtarı koy. Anahtarı API Konsolu’nda Downstream kapsamıyla oluştur. X-DPW-Org-Token kabul edilir ve yok sayılır.

Test edilecek herkese açık bir spesifikasyon olmadığından, bu yüzeye yönelik ilk geçiş doğrulama olarak Dockflow ile birlikte yürütülür. Planlamak için destek ekibiyle iletişime geç.

Sahte bir anahtarla örnek bir durum:

POST /compat/cargoes-flow/createShipments
X-DPW-ApiKey: prod_acme_FAKE-TOKEN

{"uploadType":"FORM_BY_MBL_NUMBER","formData":[{"mblNumber":"MB-4471","oceanLine":"MAEU"}]}

Yanıt:

{"result":"SUCCESS","errorDetail":[],
 "shipments":[{"shipmentNumber":"DF74123","mblNumber":"MB-4471","created":true}]}

Satırlar ya hep ya hiç mantığıyla işlenir: formData içindeki tek bir hatalı satır, hiçbir şeyin oluşturulmaması anlamına gelir ve yanıt HTTP 200 ile FAILED ve errorDetail olur.

GET /shipments ve shipmentNumber=DF74123 ile oku. Kutu başına bir satır için includeUniqueContainers=true ekle. Emisyonlar ve kara bacakları boş kalır. Her webhook teslimatı bir X-Dockflow-Signature başlığı taşır.

Tam alan eşlemesi ve imza kontrolü: