API anahtarınızı alın
Önce bir Zonos hesabına kaydolun ve hesabınızı Zonos Dashboard adresinde yapılandırın. Daha sonra Zonos API ile kimlik doğrulaması yapmanıza izin verecek olan API anahtarınızı alabileceksiniz.
Almak istediğiniz ayrıntılara karar verin
GraphQL'in çalışma şekli nedeniyle, API'den yalnızca ilgilendiğiniz alanları isteyebilir veya bir siparişle ilişkili tüm sistem bilgilerini istemeyi seçebilirsiniz - seçim size aittir. Mevcut alanlar için GraphQL API referansına göz atın.
Siparişle ilişkili bilgiler, varış maliyeti teklifi ayrıntıları, sevkiyat oranı ayrıntıları, sepet ayrıntıları vb., bu nesnelerden alanlar ekleyerek order sorgunuz aracılığıyla grafikte sorgulanabilir.
En azından, API'yi sorgulayabilmek için bir sipariş numarasına ihtiyacınız vardır. Bu, GraphQL isteğinizde değişkenler ile orderId alanında iletilir.
query order($orderId: String!) { order(orderId: $orderId) { # ... other field names here }}İsteğinizi gönderin
İsteğinizi oluşturduktan ve yapılandırdıktan sonra, Zonos API'sine POST isteği gönderebilirsiniz. API anahtarınız ile kimlik doğrulaması yaptığınızdan ve isteğinizde doğru sürüm başlığını sağladığınızdan emin olun.
POST https://api.zonos.com/graphql
query order($orderId: String!) { order(orderId: $orderId) { accountOrderNumber amountSubtotals { duties taxes fees shipping items } landedCosts { id rootId tariffRate duties { amount currency formula item { id description } exchangeRate { rate sourceCurrencyCode targetCurrencyCode } } fees { amount currency description note formula type item { id description } exchangeRate { rate } } taxes { amount currency formula item { id description } exchangeRate { rate } } deMinimis { formula method note threshold type } shipmentRating { id amount currencyCode displayName minTransitAt maxTransitAt details amount carrierCode amountSubtotals shipping fuelSurcharge insuranceCost otherSurcharge shipmentRatingCartons chargeableWeight carton length width height weight shippingProfile id customServiceLevelCode landedCostMethod serviceLevel code
Sipariş ayrıntılarını al
GraphQL ile sipariş ayrıntılarınızı alın.Zonos sistemindeki uluslararası siparişlerinizin ayrıntılarını almak için GraphQL API'sini sorgulayabilirsiniz. Bu, sipariş ayrıntılarını ve sevkiyat oranları, varış maliyeti teklifleri vb. gibi bir siparişle ilişkili geçerli bilgileri almanıza olanak tanır.