DOCS

Siparişleri arama ve filtreleme

Siparişleri arama ve filtreleme

GraphQL ile sipariş listelerini alın.

orders sorgusunu GraphQL'de kullanarak, çeşitli kriterlere göre sayfalı sipariş listeleri alabilirsiniz. Bu, ülkeye göre, belirli tarihler arasında sipariş listesi oluşturmanız gerektiğinde, arama yaparken vb. faydalıdır.

1

API anahtarınızı alın

Bir Zonos hesabı edinin: Zonos API'sini kullanmak için bir API anahtarına ihtiyacınız olacak. Anahtarınızı almak için kayıt formumuzu doldurmanız gerekecek. Hesap anlaşmanız yapıldıktan sonra onboarding süreci başlayacaktır. Onboarding sırasında, bir temsilci hesabınızı doğru bir şekilde ayarlamanıza yardımcı olacak, böylece en doğru API yanıtlarını alabilirsiniz.

Eğer bir Zonos hesabınız varsa, API anahtarınıza buradan erişebilirsiniz. Bu, Zonos API'si ile kimlik doğrulamanızı sağlar. Eğer bir hesabınız yoksa yukarıdaki notu kontrol edin.

2

Hangi detayları alacağınıza karar verin

Sipariş listelerini benzer accountOrderId'lere göre veya siparişlerin yayınlandığı tarih aralığını belirterek sorgulayabilirsiniz. Mevcut alanların tam listesi için GraphQL API referansına başvurun.

Sorguladığınız her bir siparişte, tüm normal Order alanları mevcuttur, örneğin, ülke, gönderim bilgileri, landed cost toplamları vb.. Tüm olası alanlar GraphQL API referansında listelenmiştir.

Sorgu

1
2
3
4
5
6
7
8
9
10
query orders($ordersFilter: OrdersFilter, $first: Int) {
  orders(filter: $ordersFilter, first: $first) {
    edges {
      node {
        id
        # ... field names here
      }
    }
  }
}

Değişkenler

1
2
3
4
5
6
7
8
{
  "ordersFilter": {
    "between": {
      "before": "2022-10-01",
      "after": "2022-09-01"
    }
  }
}
3

Sayfaları almak için gönderin

Listeyi getiren tüm sorgular Relay tarzı sayfalama destekler. first değişkeni, kaç nesnenin döndürüleceğini belirtmenizi sağlar.

Sorgu

1
2
3
4
5
query orders($filter: OrderFilter!, $first: Int) {
 orders(orderFilter: $filter, first: $first) {
  # ... field names here
 }
}

Değişkenler

1
2
3
{
  "first": 20
}
4

Talebinizi gönderin

Artık talebinizi oluşturdunuz ve yapılandırdınız, bir POST talebi gönderebilirsiniz Zonos API'sine. API anahtarınızla kimlik doğrulaması yaptığınızdan ve talebinizde doğru sürüm başlığını sağladığınızdan emin olun.

POST https://api.zonos.com/graphql/

Sorgu

1
2
3
4
5
6
7
8
9
10
11
12
13
14
query orders($ordersFilter: OrdersFilter, $first: Int) {
  orders(filter: $ordersFilter, first: $first) {
    edges {
      node {
        id
        items {
          description
          hsCode
          quantity
        }
      }
    }
  }
}

Değişkenler

1
2
3
4
5
6
7
8
9
{
  "ordersFilter": {
    "between": {
      "before": "2022-10-01",
      "after": "2022-09-01"
    }
  },
  "first": 20
}

Yanıt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "data": [
    {
      "order": {
        "id": "1000753",
        "items": [
          {
            "description": "Blue Snorkle Set",
            "hsCode": "9506290000",
            "quantity": 2
          }
        ]
      }
    }
  ]
}

Bu sayfa yardımcı oldu mu?