Пагинация в запросах к API Яндекс Маркета для продавцов

Некоторые запросы возвращают результат не целиком, а постранично. Чтобы получить результат полностью, выполните несколько последовательных запросов — в каждом новом запросе передавайте параметр со следующей страницей результатов.

Как получить все страницы результата

Примеры методов с пагинацией по pageToken:

• POST v2/businesses/{businessId}/offer-cards
• POST v2/campaigns/{campaignId}/offer-prices
• GET v2/campaigns/{campaignId}/returns
• POST v1/businesses/{businessId}/orders

Чтобы получить результат полностью:

1. Выполните запрос, где:

   • Не передавайте pageToken.
   • При желании передайте limit. В спецификации каждого метода для параметра limit указаны значения minimum, maximum и default. Если не передать параметр, будет использовано значение по умолчанию.

   Автоматическое уменьшение limit

   Некоторые методы автоматически уменьшают переданное значение limit до maximum, если оно превышает допустимый максимум — это указано в описании параметра limit таких методов.

   Примеры методов:

   • GET v2/campaigns/{campaignId}/returns
   • POST v1/businesses/{businessId}/orders

   В ответе вернется параметр paging.

2. Если в paging вернулся параметр nextPageToken, значит, есть следующая страница результата. Повторите запрос, где передайте значение nextPageToken в параметре pageToken.

   Значение параметра nextPageToken

   Это не номер страницы, а строка, которую нужно передать в запросе.

   Если параметра нет, то вернулась последняя страница. Больше запросов делать не нужно.

3. Продолжайте выполнять запросы, пока возвращается nextPageToken.