Проверить пагинацию API

Получены ли все ожидаемые страницы?

Ответ 200 может содержать только первую страницу. Пагинация использует номер, смещение, курсор или ссылку продолжения. Метод позволяет воспроизвести проверку; точный механизм задаёт документация сервиса.

1. Зафиксировать охват

   Сохраните запрос, фильтры, версию и сортировку. Уточните, считает ли итог записи, оценку результатов или уникальные объекты. Сравнивайте одинаковые фильтры.

2. Следовать продолжению

   Читайте полученную ссылку или курсор. Записывайте переходы и выявляйте уже посещённые продолжения. Не придумывайте адреса вместо предоставленных.

3. Сверить количества

   Считайте записи и уникальные идентификаторы отдельно. Перекрытия страниц увеличивают число записей. Сохраните повторы для проверки версий до удаления.

4. Записать остановку

   Укажите конец, лимит, ошибку или прерывание. Для изменяющихся данных используйте снимок, если доступен, или отметьте ограничение. Возобновляйте с теми же фильтрами.

Ситуации и решения

Типовые ситуации для подготовки проверки. Они не описывают выполненные проекты или реальные наблюдения.

Что сохранить

• Запрос, фильтры и версия
• Переходы и ответы
• Число записей и уникальных объектов
• Причина остановки и условия возобновления

Официальные источники

• GitHub — REST pagination
• IETF — Web Linking, RFC 8288

Связанные карточки источников

• data.gouv.fr
• Eurostat · Data Browser
• Crossref Metadata Search
• Companies House

Связанные протоколы

• Запросить публичный API и сохранить проверяемую выгрузку
• Сохранить воспроизводимую версию открытых данных
• Проверка соединения двух файлов данных

Проверки перед выводом

• Стабильны ли фильтры?
• Не повторяются ли продолжения?
• Объяснены ли повторы?
• Ясна ли причина остановки?

Журнал с разделением технического успеха, наблюдаемого охвата и прерывания.