Müşterim, Windward’ın okyanus takip API’sine GraphQL gönderiyor. Sorgular olduğu gibi kalabilir mi?
Evet, sorgular ve mutasyonlar olduğu gibi kalabilir. URL ve kimlik bilgisi değişiyor; bu ikisi Dockflow’un kendi tasarımı, çünkü Windward bunları yayımlamıyor:
- https://api.dockflow.com/compat/windward/graphql adresine gönderin.
- x-api-key içinde ya da Bearer token olarak bir Dockflow API anahtarı gönderin. İstemciniz publicAPIToken çağırıyorsa anahtarı clientSecret içine koyun.
Bu yüzeye ilk geçiş, doğrulama amacıyla Dockflow ile birlikte yürütülür; bu yüzden planlamak için destek ekibiyle iletişime geçin.
Sahte bir anahtarla örnek bir durum:
POST /compat/windward/graphql
x-api-key: prod_acme_FAKE-TOKEN
{"query":"mutation($s:[TrackedShipmentInput!]!){upsertTrackedShipments(shipments:$s){id}}",
"variables":{"s":[{"bol":"BL-7741","metadata":{"jobNumber":"PO-5521"}}]}}
Yanıt id’yi içerir:
{"data":{"upsertTrackedShipments":[{"id":"000000000000000000012345"}]}}
Windward tarafından verilen id’ler çözümlenmez, bu yüzden her gönderiyi bir kez upsert edin. Liste yalnızca id ve konteyner numarasına göre filtreleme yapar. sort ve orderBy argümanları kabul edilir ve yok sayılır. Gemi ve şirket taraması kapsam dışıdır. Her webhook teslimatı bir X-Dockflow-Signature başlığı taşır.
Tam alan eşlemesi ve imza kontrolü: