Перейти к основному содержанию
Списковые ручки возвращают результаты страницами. Управление — параметрами limit и page_token.

​
Как это работает

Передайте next_page_token в следующий запрос, чтобы получить следующую страницу. Пустой next_page_token означает, что страниц больше нет.
  • limit — по умолчанию 100, максимум 1000.
  • page_token — непрозрачный. Не разбирайте и не конструируйте его; передавайте ровно то значение, что получили.
Токен привязан к набору фильтров, для которого был выдан. Если передать его в запрос с другими status, department_id, updated_since или limit, ответ будет 400 с кодом DEVELOPER.INVALID_PAGE_TOKEN. Меняете фильтры — начинайте обход заново без токена.

​
Общее число

По умолчанию число всех подходящих записей не считается. Запросите его явно через include_total=true:
Поле total_count появляется в ответе. На больших выборках (свыше ~10 000 записей) это оценка планировщика, а не точное число.

​
Инкрементальная синхронизация

Чтобы забирать только изменения, фильтруйте по updated_since (RFC 3339):
updated_since отражает изменения самой карточки сотрудника. Переименование связанных сущностей (человек, отдел) в это поле не попадает — для них используйте вебхуки: переименование человека приходит как person.changed, а не как employee.changed. Для сверки удалений периодически перечитывайте список целиком.Смещение часового пояса в query кодируйте как %2B05:00 или присылайте время в Z (UTC): «плюс» в URL иначе трактуется как пробел.