Ottenere la chiave API
Ottenere un account Zonos: Per utilizzare l'API Zonos avrà bisogno di una chiave API. Per ottenerla dovrà compilare il nostro modulo di registrazione. L'onboarding inizierà una volta che avrà un accordo account in vigore. Durante l'onboarding, un referente La aiuterà a configurare correttamente il Suo account per ottenere le risposte API più accurate.
Acceda alla Sua chiave API qui se ha un account Zonos. Questo Le consentirà di autenticarsi con l'API Zonos. Se non ha un account, veda la nota sopra.
Decidere quali dettagli recuperare
Può interrogare elenchi di ordini in base a accountOrderId simili o fornendo un intervallo di date in cui gli ordini sono stati pubblicati. Per un elenco completo dei campi disponibili, consulti il riferimento API GraphQL.
Su ciascun ordine che interroga, sono disponibili tutti i normali campi Order, ad esempio il paese, le informazioni di spedizione, i totali Landed Cost, ecc.. Tutti i campi possibili sono elencati nel riferimento API GraphQL.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id # ... field names here } } }}Specificare le pagine da recuperare
Tutte le query che recuperano elenchi supportano la paginazione in stile Relay. La variabile first Le consente di specificare quanti oggetti vengono restituiti.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id } } pageInfo { hasNextPage endCursor } }}Inviare la richiesta
Ora che ha creato e configurato la Sua richiesta, può inviare una richiesta POST all'API Zonos. Si assicuri di autenticarsi con la Sua chiave API e di fornire l'intestazione di versione corretta nella Sua richiesta.
POST https://api.zonos.com/graphql
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id items { description hsCode quantity } } } }}
Cercare e filtrare gli ordini
Recuperi elenchi di ordini con GraphQL.Utilizzando la query
ordersin GraphQL, può recuperare elenchi paginati di ordini con vari criteri. È utile quando Le serve un elenco di ordini per paese, tra date specifiche, per creare una ricerca, ecc.