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ę.
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
query orders($ordersFilter: OrdersFilter, $first: Int) {
orders(filter: $ordersFilter, first: $first) {
edges {
node {
id
# ... field names here
}
}
}
}
Zmienne
{
"ordersFilter": {
"between": {
"before": "2022-10-01",
"after": "2022-09-01"
}
}
}
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
query orders($filter: OrderFilter!, $first: Int) {
orders(orderFilter: $filter, first: $first) {
# ... field names here
}
}
Zmienne
{
"first": 20
}
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
query orders($ordersFilter: OrdersFilter, $first: Int) {
orders(filter: $ordersFilter, first: $first) {
edges {
node {
id
items {
description
hsCode
quantity
}
}
}
}
}
Zmienne
{
"ordersFilter": {
"between": {
"before": "2022-10-01",
"after": "2022-09-01"
}
},
"first": 20
}
Odpowiedź
{
"data": [
{
"order": {
"id": "1000753",
"items": [
{
"description": "Blue Snorkle Set",
"hsCode": "9506290000",
"quantity": 2
}
]
}
}
]
}
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.