Взаимодействие / 1 / 5
Стили API
Один экран приложения доставки еды, «Мои заказы», сначала на REST, потом на GraphQL, а между сервисами — gRPC. Где каждый стиль берёт слишком много или слишком мало и какие привычки нужны любому API: курсорная пагинация, версии и ключи идемпотентности.
- 12 мин
- Начальный
- 12 шагов
- Запросов на экран
- 1
- Загрузка экрана
- 180 мс
- Данных на экран
- 0,1 МБ
- Двойные заказы
- 0 /день
- запрос
- ответ
- повторная доставка
- дубликат
- потеряно
Цифры — модельный сценарий, не замеры
Настоящий запрос
Приложение → REST APIЗапрос
GET /v1/orders?limit=20 HTTP/1.11
Host: api.example.com
Ответ
HTTP/1.1 200 OK
{
"data": 2[
{
"id": "ord_981",
"status": "delivered",
"total": 84000,
"restaurant_id": 3"r_7",
"address": { ... },
"items": 4[ ... ]
}
]
}
GET— Только чтение. Повторять безопасно, кешировать легко.data— Сам список. Под отдельным ключом — чтобы рядом было место для данных о страницах.restaurant_id— Только ID. Экрану нужно название, а его здесь нет.items— Тяжёлые поля, которые экран никогда не показывает, но получает при каждой загрузке.
Курс: Уроков: 42
01 Основы
02 Масштабирование
03 Данные и хранение
04 Взаимодействие
05 Надёжность
06 Архитектура
07 Безопасность
08 Поставка
09 Целые системы
10 Бизнес-процессы