DOCS

搜尋和篩選訂單

Checkout•
首頁全球電商 整合 整合 Checkout 搜尋和篩選訂單

搜尋和篩選訂單

使用 GraphQL 擷取訂單列表。

使用 GraphQL 中的 orders 查詢，您可以擷取具有各種條件的分頁訂單列表。當您需要依據國家取得訂單列表、獲取特定日期範圍內的訂單、建構搜尋功能等時，此方法非常實用。

1

取得您的 API 金鑰

取得 Zonos 帳戶： 為了使用 Zonos API，您需要 API 金鑰。若要取得金鑰，您需要填寫我們的申請表單。一旦您有帳戶協議，上線流程將開始。在上線期間，代表會幫助您正確設定帳戶，以便您能夠取得最準確的 API 回應。

如果您已有 Zonos 帳戶，請存取您的 API 金鑰。這將允許您使用 Zonos API 進行身份驗證。如果您還沒有帳戶，請參閱上面的說明。

您可以根據類似的 accountOrderId 或提供訂單發佈時間範圍的日期範圍來查詢訂單列表。如需完整的可用欄位清單，請查閱 GraphQL API 參考。

在您查詢的每個訂單上，所有常規 Order 欄位都可用，例如 國家、運送資訊、到岸成本總計等。所有可能的欄位都列在 GraphQL API 參考中。

1query orders($ordersFilter: OrdersFilter, $first: Int) {
2 orders(filter: $ordersFilter, first: $first) {
3 edges {
4 node {
5 id

所有擷取列表的查詢都支援 Relay 風格的分頁。first 變數允許您指定傳回多少個物件。

1query orders($ordersFilter: OrdersFilter, $first: Int) {
2 orders(filter: $ordersFilter, first: $first) {
3 edges {
4 node {
5 id
6 }
7 }
8 pageInfo {
9 hasNextPage
10 endCursor
11 }
12 }
13}

現在您已建構並設定要求，您可以向 Zonos API 傳送 POST 要求。請確保使用您的 API 金鑰進行身份驗證，並在要求中提供正確的版本標頭。

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

1query orders($ordersFilter: OrdersFilter, $first: Int) {
2 orders(filter: $ordersFilter, first: $first) {
3 edges {
4 node {
5 id
6 items {
7 description
8 hsCode
9 quantity
10 }
11 }
12 }
13 }
14}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

OrdersFilter

預約演示

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 取得您的 API 金鑰