Kan een Windward GraphQL-trackingclient op Dockflow draaien, en wat moet er veranderd worden?

Hoe-te Q&A
1

Mijn klant stuurt GraphQL naar Windwards ocean tracking-API. Kunnen de queries blijven staan?

Ja, de queries en mutations kunnen blijven staan. De URL en de inloggegevens veranderen, en die twee zijn van Dockflow zelf, omdat Windward ze niet publiceert:

  1. Stuur naar https://api.dockflow.com/compat/windward/graphql
  2. Stuur een Dockflow API-sleutel mee in x-api-key, of als Bearer-token. Als je client publicAPIToken aanroept, zet de sleutel dan in clientSecret.

De eerste overstap naar dit oppervlak gebeurt samen met Dockflow, als validatie, dus neem contact op met support om het te plannen.

Een uitgewerkt voorbeeld, met een nep-sleutel:

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

Het antwoord bevat de id:

{"data":{"upsertTrackedShipments":[{"id":"000000000000000000012345"}]}}

Id’s die door Windward zijn uitgegeven, werken niet, dus doe elke zending één keer een upsert. De lijst filtert alleen op id en containernummer. De argumenten sort en orderBy worden geaccepteerd en genegeerd. Screening van schepen en bedrijven wordt niet ondersteund. Elke webhook-levering bevat een X-Dockflow-Signature-header.

Volledige veldmapping en de handtekeningcontrole: