使用 GraphQL 中的 orders 查詢，您可以擷取符合各種條件的分頁訂單清單。當您需要按國家、特定日期範圍取得訂單清單，或建立搜尋功能等情況時，這非常有用。
orders
取得 Zonos 帳戶： 為使用 Zonos API，您需要一個 API 金鑰。如要取得金鑰，您需要填妥我們的登記表格。一旦帳戶協議生效，登記程序便會展開。在登記期間，代表將協助您正確設定帳戶，確保您取得最準確的 API 回應。
如果您已有 Zonos 帳戶，可在此存取您的 API 金鑰。這將讓您能夠向 Zonos API 進行身份驗證。如果您還沒有帳戶，請參閱上方的說明。
您可以根據相似的 accountOrderId 或提供訂單發佈的日期範圍來查詢訂單清單。如需完整的可用欄位清單，請參閱 GraphQL API 參考資料。
accountOrderId
在您查詢的每一筆訂單中，所有一般的 Order 欄位均可使用，例如：國家、運送資訊、落地成本總額等。所有可能的欄位均列於 GraphQL API 參考資料 中。
Order
query orders($ordersFilter: OrdersFilter, $first: Int) {
orders(filter: $ordersFilter, first: $first) {
edges {
node {
id
# ... field names here
}
所有擷取清單的查詢均支援 Relay 式分頁。first 變數可讓您指定要傳回的物件數量。
first
pageInfo {
hasNextPage
endCursor
現在您已建立並設定好請求，即可向 Zonos API 傳送 POST 請求。請確保使用您的 API 金鑰進行身份驗證，並在請求中提供正確的版本標頭。
POST
POST https://api.zonos.com/graphql
https://api.zonos.com/graphql
items {
description
hsCode
quantity
OrdersFilter
搜尋及篩選訂單
搜尋及篩選訂單
使用 GraphQL 擷取訂單清單。使用 GraphQL 中的
orders查詢，您可以擷取符合各種條件的分頁訂單清單。當您需要按國家、特定日期範圍取得訂單清單，或建立搜尋功能等情況時，這非常有用。取得您的 API 金鑰
如果您已有 Zonos 帳戶，可在此存取您的 API 金鑰。這將讓您能夠向 Zonos API 進行身份驗證。如果您還沒有帳戶，請參閱上方的說明。
決定要擷取的詳細資料
您可以根據相似的
accountOrderId或提供訂單發佈的日期範圍來查詢訂單清單。如需完整的可用欄位清單，請參閱 GraphQL API 參考資料。在您查詢的每一筆訂單中，所有一般的
Order欄位均可使用，例如：國家、運送資訊、落地成本總額等。所有可能的欄位均列於 GraphQL API 參考資料 中。query orders($ordersFilter: OrdersFilter, $first: Int) {orders(filter: $ordersFilter, first: $first) {edges {node {id# ... field names here}}}}傳送要擷取的頁面
所有擷取清單的查詢均支援 Relay 式分頁。
first變數可讓您指定要傳回的物件數量。query orders($ordersFilter: OrdersFilter, $first: Int) {orders(filter: $ordersFilter, first: $first) {edges {node {id}}pageInfo {hasNextPageendCursor}}}傳送您的請求
現在您已建立並設定好請求，即可向 Zonos API 傳送
POST請求。請確保使用您的 API 金鑰進行身份驗證，並在請求中提供正確的版本標頭。POST
https://api.zonos.com/graphqlquery orders($ordersFilter: OrdersFilter, $first: Int) {orders(filter: $ordersFilter, first: $first) {edges {node {iditems {descriptionhsCodequantity}}}}}OrdersFilter
這個頁面有幫助嗎？