mufassall

Взаимодействие / 1 / 6

Стили 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 — Тяжёлые поля, которые экран никогда не показывает, но получает при каждой загрузке.

Соберите самиШпаргалкаСравнение уроков

Курс: Уроков: 74
  1. 01 Основы

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

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

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

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

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

    1. Микросервисы
    2. Обнаружение сервисов
    3. Саги и outbox
    4. Захват изменений данных (CDC)
    5. Транзакционный outbox
    6. Распределённые блокировки
    7. Batch и stream
    8. Мультитенантность
    9. Event sourcing
  7. 07 Безопасность

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

    1. Тестирование
    2. CI/CD: от коммита до продакшена
    3. Миграции без простоя
    4. Фича-флаги
  9. 09 Целые системы

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

    1. Платёжный шлюз
    2. Деньги и округление
    3. Двойная запись в учёте денег
    4. Сверка платежей
    5. Биллинг подписок
    6. Электронная цифровая подпись
    7. Жизненный цикл документа
    8. Журнал аудита
    9. Доставка уведомлений
    10. Массовый импорт
    11. Возвраты и чарджбэки
    12. Сквозная нумерация документов
  11. 11 Разборы реальных систем

    1. Разбор: как Discord хранит сообщения
    2. Разбор: совместное редактирование в Figma