mufassall

Взаимодействие / 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[ ... ]
    }
  ]
}
  1. GET — Только чтение. Повторять безопасно, кешировать легко.
  2. data — Сам список. Под отдельным ключом — чтобы рядом было место для данных о страницах.
  3. restaurant_id — Только ID. Экрану нужно название, а его здесь нет.
  4. items — Тяжёлые поля, которые экран никогда не показывает, но получает при каждой загрузке.
Курс: Уроков: 42
  1. 01 Основы

    1. Жизнь одного запроса
    2. Задержка и пропускная способность
    3. Оценка на салфетке
  2. 02 Масштабирование

    1. Вертикальное и горизонтальное масштабирование
    2. Балансировка нагрузки
    3. Серверы без состояния
    4. Кеширование
    5. CDN и кеш на краю сети
  3. 03 Данные и хранение

    1. SQL и NoSQL
    2. Индексы в базе данных
    3. Движки хранения: B-tree и LSM
    4. Репликация базы данных
    5. Шардирование
    6. Консистентное хеширование
    7. Уникальные идентификаторы
    8. CAP: когда рвётся связь
    9. Консенсус и выбор лидера
    10. Транзакции
    11. Загрузка файлов
  4. 04 Взаимодействие

    1. Стили API
    2. Очереди сообщений
    3. Pub/sub и журнал событий
    4. Обновления в реальном времени
    5. Надёжные колбэки
  5. 05 Надёжность

    1. Резервирование и failover
    2. Rate limiting
    3. Таймауты и ретраи
    4. Наблюдаемость
  6. 06 Архитектура

    1. Микросервисы
    2. Обнаружение сервисов
    3. Саги и outbox
    4. Batch и stream
  7. 07 Безопасность

    1. Аутентификация
    2. Авторизация
    3. Шифрование и секреты
  8. 08 Поставка

    1. Тестирование
    2. CI/CD: от коммита до продакшена
  9. 09 Целые системы

    1. От требований к дизайну
    2. Проектируем сокращатель ссылок
    3. Проектируем ленту новостей
    4. Проектируем чат
  10. 10 Бизнес-процессы

    1. Платёжный шлюз