Валентная нумерация запросов на получение

Question

У меня есть несколько вопросов о нумерации страниц.

1. Можно ли форсировать нумерацию страниц?
2. Можно ли контролировать нумерацию страниц (например, запросить страницы из 200 записей)?
3. Если ответы на вопросы 1 и 2 - нет, каков порог, когда происходит разбиение на страницы?
4. Является ли разбиение на страницы стабильным (одинаковое количество записей на одном и том же объекте всегда будет разбито на страницы или не разбито на страницы)?

Спасибо,

Влад

Answer 1

1. Разбивка на страницы обязательна, когда он используется для определенного вызова API: независимо от того, сколько записей он находит, этот вызов всегда возвращает данные в страницах. Вы не можете запросить разбиение на страницы для вызовов, которые по умолчанию не разбиты на страницы. Вызов либо нумеруется, либо нет.

2. В настоящее время вы не можете запросить изменение размера страниц данных; количество записей, возвращаемых на каждой странице в постраничном наборе, фиксировано для каждого вызова с использованием страниц (теоретически размер страницы может варьироваться с каждым таким вызовом, на практике это (в настоящее время) не изменяется).

3. Порогового значения не существует: либо данные в вызове возвращаются в виде постраничного набора результатов, либо это не так. Если число совпадающих результатов меньше размера страницы, вызов должен по-прежнему возвращать одну страницу данных в структуре постраничного набора результатов со свойством, указывающим, что дальнейшие страницы данных недоступны.

4. Да, он стабилен: вы можете рассчитывать на то, что вызов с постраничными результатами всегда будет возвращать постраничные результаты, и что число результатов, возвращаемых на странице, будет оставаться статическим (до тех пор, пока версия продукта для вашей службы не изменится: обновления продукта может изменить размер страниц данных в постраничных результатах).

Вы не должны писать код, который не может справиться с изменением размера страницы или который должен знать, какой размер страницы (потому что это может измениться с новой версией продукта без изменения контрактной версии API), но это безопасно написать код, который предполагает, что результаты от вызова API A всегда будут разбиты на страницы (если в документах сказано, что он возвращает постраничные результаты).