DOCS

Searching and filtering orders

/

Wyszukiwanie i filtrowanie zamówień

Pobierz listy zamówień za pomocą GraphQL.

Korzystając z zapytania orders w GraphQL, możesz pobierać paginowane listy zamówień według różnych kryteriów. Jest to przydatne, gdy potrzebujesz listy zamówień według kraju, w określonych datach, aby zbudować wyszukiwanie itp.

1

Uzyskaj swój klucz API

Uzyskaj konto Zonos: Aby korzystać z API Zonos, będziesz potrzebować klucza API. Aby uzyskać swój klucz, musisz wypełnić nasz formularz rejestracyjny. Proces wprowadzania do systemu rozpocznie się, gdy będziesz miał umowę na konto. Podczas wprowadzania do systemu przedstawiciel pomoże Ci poprawnie skonfigurować konto, abyś otrzymywał jak najdokładniejsze odpowiedzi API.

Uzyskaj swój klucz API tutaj, jeśli masz konto Zonos. To pozwoli Ci uwierzytelnić się w API Zonos. Jeśli nie masz konta, zobacz powyższą notatkę.

2

Zdecyduj, jakie szczegóły chcesz pobrać

Możesz zapytać o listy zamówień na podstawie podobnych accountOrderId lub podając zakres dat, w którym zamówienia zostały opublikowane. Aby uzyskać pełną listę dostępnych pól, zapoznaj się z dokumentacją API GraphQL.

Na każdym indywidualnym zamówieniu, które zapytasz, dostępne są wszystkie normalne pola Order, np. kraj, informacje o wysyłce, całkowite koszty landed cost itp. Wszystkie możliwe pola są wymienione w dokumentacji API GraphQL.

Zapytanie

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

Zmienne

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

Wyślij strony do pobrania

Wszystkie zapytania, które pobierają listy, obsługują paginację w stylu Relay. Zmienna first pozwala określić, ile obiektów ma zostać zwróconych.

Zapytanie

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

Zmienne

1
2
3
{
  "first": 20
}
4

Wyślij swoje zapytanie

Teraz, gdy zbudowałeś swoje zapytanie i je skonfigurowałeś, możesz wysłać żądanie POST do API Zonos. Upewnij się, że uwierzytelniasz się za pomocą swojego klucza API i podajesz poprawny nagłówek wersji w swoim żądaniu.

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

Zapytanie

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

Zmienne

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

Odpowiedź

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

Czy ta strona była pomocna?