Hämta er API-nyckel
Skaffa ett Zonos-konto: För att använda Zonos API behöver ni en API-nyckel. För att få er nyckel behöver ni fylla i vårt anmälningsformulär. Onboarding börjar när ett kontoavtal finns på plats. Under onboarding hjälper en representant er att konfigurera kontot korrekt så att ni får så precisa API-svar som möjligt.
Hämta er API-nyckel här om ni har ett Zonos-konto. Den låter er autentisera mot Zonos API. Om ni inte har ett konto, se anteckningen ovan.
Bestäm vilka uppgifter ni vill hämta
Ni kan fråga efter orderlistor baserat på liknande accountOrderId:n eller genom att ange ett datumintervall under vilket ordrarna publicerades. En komplett lista över tillgängliga fält finns i GraphQL API-referensen.
På varje enskild order ni frågar efter är alla vanliga Order-fält tillgängliga, t.ex. land, fraktinformation, totalsummor för landed cost med mera. Alla möjliga fält listas i GraphQL API-referensen.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id # ... field names here } } }}Ange vilka sidor som ska hämtas
Alla frågor som hämtar listor stöder Relay-stil paginering. Variabeln first låter er ange hur många objekt som returneras.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id } } pageInfo { hasNextPage endCursor } }}Skicka er förfrågan
När ni har byggt och konfigurerat er förfrågan kan ni skicka en POST-förfrågan till Zonos API. Se till att autentisera med er API-nyckel och ange rätt versionsheader i förfrågan.
POST https://api.zonos.com/graphql
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id items { description hsCode quantity } } } }}
Sök och filtrera ordrar
Hämta orderlistor med GraphQL.Med frågan
ordersi GraphQL kan ni hämta paginerade listor över ordrar utifrån olika kriterier. Det är användbart när ni behöver en lista över ordrar per land, mellan specifika datum, för att bygga en sökning med mera.