Иногда просто не хватает вдохновения, чтобы сделать очередной шаг вперёд 🤍

Спасибо каждому из вас за него.


И хочу напомнить:
Не забывайте благодарить, хвалить и поддерживать своих коллег.

Особенно это важно для джунов, которые работают больше всех, и стараются как за троих))
И для тех, кто только-только вышел к вам в компанию и действительно старается как можно скорее начать приносить пользу.

Обратная связь… кажется, что мелочь, но на самом деле значит очень много 🪄

🎯 6 способов пагинации в REST API 🎯

Когда мы получаем списки через API, то получать весь миллион записей сразу - плохая идея. Лучше получать по частям — порциями.

Пагинация — отвечает за порционное получение данных в REST API.

Помогает:
✔️ не перегружать как сервер, так и клиента API;
✔️ ускорить отклик на запрос;
✔️ пользователю не надо ждать данных вечность.


👇 6 способов пагинации на примере получения списка пользователей:

🔹 Offset
Используются параметры смещения (offset) и ограничения (limit) для определения начальной точки и количества возвращаемых записей.

GET /users?offset=0&limit=3

✅ Простая в реализации
✅ Подходит, когда данных немного
➖ Неэффективна при больших offset: система перебирает все записи, чтобы дойти до нужных


🔹 Page
Используются номер и размер каждой страницы для переключения между ними.

GET /users?page=2&size=10

✅ Привычно для пользователей (страницы)
✅ Подходит, когда пользователь реально листает страницы
➖ Проблемы те же, что у offset


🔹 Cursor
Используется курсор (id записей в БД) для обозначения позиции в наборе данных.

GET /users?cursor=123

✅ Быстрая и надёжная при больших объёмах данных.
✅ Часто используют в соцсетях, чатах и платежных системах из-за постоянного потока новых данных.


🔹 Keyset
Используется ключ для фильтрации набора данных. Часто это первичный ключ или другой индексированный столбец.

GET /users?afterId=123&limit=3

✅ Быстрая при больших данных
✅ Подходит для бесконечной прокрутки (infinite scroll)
➖ Требует уникального и индексированного поля (обычно ID)


🔹 Time
Используются временные метки или дата для разбиения записей на страницы.

GET /users?startTime=...&endTime=...

✅ Идеальна для систем, где данные привязаны ко времени: логи, события, аналитика


🔹 Гибридная пагинация
Этот метод объединяет несколько методов пагинации, чтобы максимально использовать их сильные стороны.

Поддерживается сразу несколько способов

из перечисленных выше

➖ Чуть сложнее реализовать
➖ Может путать клиентов API


#RestApiGA #MeetsGA

Это точно спросят на собеседовании про REST API

Смотреть до конца и искать что не так 😉

Жду ваши комментарии ✍️

#RestApiGA

📚 Что почитать и посмотреть по REST API: подборка материалов от GetAnalyst 📚

У нас много новых участников в сообществе 🙌 И…!
Вместо того, чтобы рассказывать о себе, сделала для вас самую полную и актуальную подборку полезных материалов по проектированию REST API.

Так вы лучше узнаете меня - Екатерину Ананьеву - не на словах, а в деле 🙂

Материалы расположены по порядку - от простого к сложному.
Они помогут вам сделать крутой прорыв в освоении темы и разобраться в сложных вопросах.

(С) Структура метода REST API

(В) Postman: навык тестирования REST API за вечер

(С) Методы HTTP (REST) и их назначение

(C) Как строить URL в REST API

(C) Всё про JSON в одной картинке

(С) Мини-книга про JSON

(В) Связь БД и дизайна REST API

(С) Headers

(С) 6 способов пагинации

(С) Проектирование ошибок в REST API

(В) Проект “Система для автосервиса” - видео-обучение:
1. Сбор бизнес-требований, погружение в контекст
2. Определение сущностей и проектирование логической модели БД
3. REST API с нуля: дизайн методов для работы менеджера с заявками автосервиса

(С) 6 ключевых принципов REST API - теория, но спрашивают понимание

(C) Postman: Практическое руководство с примером тестирования открытого API DaData

(С) Postman: Практическое руководство с примером - API DaData - ещё один сервис

(C) Postman: Практическое руководство с примером - платежная система ВТБ

(П) Вопросы и ответы по REST API: собеседование на СА

(В) Собеседование на СА: разбор задачи на асинхронные запросы в REST API

(C) Шаблон постановки задачи на REST API метод

(П) gRPС vs REST - что выбрать для проекта

(C) Проектирование REST API: спорные вопросы с проектов и собеседований на системного аналитика (и не только)

(С) Исследование реальных REST API на соответствие REST: Trello, Todoist

Также вы можете найти у нас мини-обучения и продвинутую практическую программу Дизайн REST API для опытных аналитиков.

(В) Видео
(П) Подкасты
(С) Статьи


Делитесь с коллегами, особенно с джунами и мидлами СА!

Сохранили? ❤️

#RestApiGA