Uzyskaj swój klucz API
Załóż 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ę o 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
ordersw GraphQL, możesz pobrać 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, do budowy wyszukiwania itp.