DOCS

搜索和筛选订单

Checkout•
首页全球电商 集成 集成结账 搜索和筛选订单

搜索和筛选订单

使用 GraphQL 检索订单列表。

使用 GraphQL 中的 orders 查询，您可以检索具有各种条件的分页订单列表。当您需要按国家、特定日期之间或构建搜索等方式获得订单列表时，这很有用。

1

获取您的 API 密钥

获取 Zonos 账户： 要使用 Zonos API，您需要一个 API 密钥。要获取您的密钥，您需要填写我们的 注册表单。一旦您有账户协议，入职流程将开始。在入职期间，代表将帮助您正确设置您的账户，以便获得最准确的 API 响应。

如果您有 Zonos 账户，请在此处访问您的 API 密钥。这将允许您使用 Zonos API 进行身份验证。如果您没有账户，请参阅上面的注意事项。

您可以基于类似的 accountOrderId 查询订单列表，或者通过提供发布订单的日期范围。有关可用字段的完整列表，请查阅 GraphQL API 参考。

在您查询的每个订单上，所有常见的 Order 字段都可用，例如 国家、运输信息、Landed cost 总额等。所有可能的字段都列在 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 密钥