Пагинация
Списочные эндпоинты возвращают данные постранично с помощью query-параметров `page` и `limit`.
Параметры
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
page | integer | 1 | Номер страницы, начиная с 1 |
limit | integer | 20 | Размер страницы (обычно до 100) |
Некорректные значения (
page < 1, слишком большой limit) возвращают 400 invalid_params. Максимальный limit может отличаться по эндпоинтам.Фильтры
Многие списки поддерживают дополнительные query-параметры — например, q для текстового поиска и status для фильтра по статусу. Доступные фильтры указаны в карточке каждого эндпоинта.
Форма ответа
В data лежит массив элементов и метаданные страницы: total, page, limit. Ключ массива назван по сущности — например, users для пользователей, courses для курсов.
Запрос
curl "https://api.edumentor.kz/api/v1/t/users?page=1&limit=20&q=айгерим" \
-H "Authorization: Bearer <token>" \
-H "X-Tenant-Subdomain: acme"Ответ
{
"success": true,
"data": {
"users": [
{ "id": "8f3b1c2a-...", "email": "student@acme.kz", "role": "student" }
],
"total": 134,
"page": 1,
"limit": 20
}
}Чтобы получить следующую страницу, увеличьте page. Общее число страниц = ceil(total / limit).