Это проектная спецификация, а не работающее API: реализации ещё нет, адреса могут измениться.

Страница ещё не написана. Ниже — что об этом уже известно

Пагинация, фильтры, сортировка

Курсор вместо смещения #

Почему не offset: при вставке записей во время обхода объекты дублируются или теряются.

Единый синтаксис поле[оператор]=значение для всех ресурсов.

Сегмент, собранный в интерфейсе, сразу доступен как фильтр API — логику сегментации не надо повторять у себя.

Как избавиться от N+1 запросов.

Отдать интеграции ровно то, что ей нужно.