---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/concepts/pagination.md
  - https://yandex.com/dev/market/partner-api/doc/ru/concepts/pagination.md
  - https://yandex.com/dev/market/partner-api/doc/zh/concepts/pagination.md
  - href: zh/concepts/pagination.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 请求中的分页 Yandex Market API 卖家须知

有些查询不会完整返回结果，而是逐页返回结果。 要获得完整结果，请运行多个连续查询。 — 在每个新请求中，传递一个带有下一页结果的参数。

{% note warning "过时的分页类型" %}

某些方法支持使用页码（参数）进行分页 `page`). 这种分页已经过时了 — 不要用它。 如果方法中两种类型的分页都可用，请使用 `pageToken`.

{% endnote %}

## 如何获取所有结果页面 {#page-token}

通过分页的方法示例 `pageToken`:

* [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/zh/reference/content/getOfferCardsContentStatus.md)
* [POST v2/campaigns/{campaignId}/offer-prices](https://yandex.com/dev/market/partner-api/doc/zh/reference/prices/getPricesByOfferIds.md)
* [GET v2/campaigns/{campaignId}/returns](https://yandex.com/dev/market/partner-api/doc/zh/reference/returns/getReturns.md)
* [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md)

要获得完整的结果:

1. 在哪里提出要求:

   * 不要把它传递出去 `pageToken`.
   * 如果需要，发送 `limit`. 在参数的每个方法的规范中 `limit` 值被指定 `minimum`, `maximum` 和 `default`. 如果不传递参数，将使用默认值。

   {% note warning "自动减少 `limit`" %}

   有些方法会自动减少传递的值。 `limit` 以前 `maximum` 如果超过允许的最大值 — 这在参数描述中指出。 `limit` 这样的方法。

   方法的例子:
      * [GET v2/campaigns/{campaignId}/returns](https://yandex.com/dev/market/partner-api/doc/zh/reference/returns/getReturns.md)
      * [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md)

   {% endnote %}

   响应将返回参数 `paging`.

2. 如果在 `paging` 返回的参数 `nextPageToken` 所以，有结果的下一页。 重复请求，其中传递值 `nextPageToken` 在参数中 `pageToken`.

   {% note warning "参数值 `nextPageToken`" %}

   这不是页码，而是需要在请求中传递的字符串。

   {% endnote %}

   如果没有参数，则返回最后一页。 提出更多要求 **不需要**.

3. 继续执行请求，直到它返回 `nextPageToken`.