Holen Sie sich Ihren API-Schlüssel
Erstellen Sie ein Zonos-Konto: Um die Zonos-API nutzen zu können, benötigen Sie einen API-Schlüssel. Um Ihren Schlüssel zu erhalten, müssen Sie unser Anmeldeformular ausfüllen. Die Einarbeitung beginnt, sobald Sie eine Kontovereinbarung getroffen haben. Während der Einarbeitung wird ein Vertreter Ihnen helfen, Ihr Konto korrekt einzurichten, damit Sie die genauesten API-Antworten erhalten.
Zugriff auf Ihren API-Schlüssel hier, wenn Sie ein Zonos-Konto haben. Dies ermöglicht Ihnen die Authentifizierung bei der Zonos-API. Wenn Sie kein Konto haben, siehe die oben stehende Anmerkung.
Entscheiden Sie, welche Details abgerufen werden sollen
Sie können Listen von Bestellungen basierend auf ähnlichen accountOrderId
s oder durch Angabe eines Datumsbereichs abfragen, in dem die Bestellungen veröffentlicht wurden. Für eine vollständige Liste der verfügbaren Felder konsultieren Sie die GraphQL API-Referenz.
Bei jeder einzelnen Bestellung, die Sie abfragen, sind alle normalen Order
-Felder verfügbar, z.B. das Land, Versandinformationen, landed cost-Gesamtsummen usw.. Alle möglichen Felder sind in der GraphQL API-Referenz aufgeführt.
Abfrage
query orders($ordersFilter: OrdersFilter, $first: Int) {
orders(filter: $ordersFilter, first: $first) {
edges {
node {
id
# ... field names here
}
}
}
}
Variablen
{
"ordersFilter": {
"between": {
"before": "2022-10-01",
"after": "2022-09-01"
}
}
}
Senden Sie die Seiten zum Abrufen
Alle Abfragen, die Listen abrufen, unterstützen die Relay-Style-Paginierung. Die Variable first
ermöglicht es Ihnen, anzugeben, wie viele Objekte zurückgegeben werden.
Abfrage
query orders($filter: OrderFilter!, $first: Int) {
orders(orderFilter: $filter, first: $first) {
# ... field names here
}
}
Variablen
{
"first": 20
}
Senden Sie Ihre Anfrage
Nachdem Sie Ihre Anfrage erstellt und konfiguriert haben, können Sie eine POST
-Anfrage an die Zonos API senden. Stellen Sie sicher, dass Sie sich mit Ihrem API-Schlüssel authentifizieren und den richtigen Versionsheader in Ihrer Anfrage angeben.
POST https://api.zonos.com/graphql/
Abfrage
query orders($ordersFilter: OrdersFilter, $first: Int) {
orders(filter: $ordersFilter, first: $first) {
edges {
node {
id
items {
description
hsCode
quantity
}
}
}
}
}
Variablen
{
"ordersFilter": {
"between": {
"before": "2022-10-01",
"after": "2022-09-01"
}
},
"first": 20
}
Antwort
{
"data": [
{
"order": {
"id": "1000753",
"items": [
{
"description": "Blue Snorkle Set",
"hsCode": "9506290000",
"quantity": 2
}
]
}
}
]
}
Bestellungen suchen und filtern
Listen von Bestellungen mit GraphQL abrufen.Mit der
orders
-Abfrage in GraphQL können Sie paginierte Listen von Bestellungen mit verschiedenen Kriterien abrufen. Dies ist nützlich, wenn Sie eine Liste von Bestellungen nach Land, zwischen bestimmten Daten, zum Erstellen einer Suche usw. benötigen.