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

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

В зависимости от того, какой параметр нужно передать, пагинация может быть двух типов:

• с идентификатором страницы — параметр page_token;
• с номером страницы — параметр page.

Если в методе доступны оба типа пагинации, используйте идентификатор страницы (page_token), а не ее номер.

Пагинация с идентификатором страницы

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

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

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

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

   • Не передавайте page_token.
   • При желании передайте limit. Тогда этот параметр нужно будет передавать в каждом следующем запросе.

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

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

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

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

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

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

Пагинация с номером страницы

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

• GET v2/campaigns
• GET v2/campaigns/{campaignId}/orders
• GET v2/regions/{regionId}/children

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

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

   • Не передавайте page.
   • При желании передайте pageSize. Тогда этот параметр нужно будет передавать в каждом следующем запросе.

   В ответе вернется параметр pager с количеством страниц результата pagesCount.

2. Если в pagesCount вернулось больше одной страницы, повторяйте запросы — в параметре page передавайте номера страниц (2, 3 и до последней).