advanced

API sketch

Sketch endpoints, events, contracts, idempotency keys, pagination, auth context, and error surfaces. Объясняйте это как practical interview step, not a memorized checklist.

Ранний эскиз API согласует клиентов, сервисы и data model. Перечислите ключевые REST или RPC endpoint, типы событий, формы запрос/ответ, курсоры пагинации, idempotency key для записи, контекст auth и коды ошибок. События дополняют API для async workflow.

На интервью держите контракты грубо — имена ресурсов, критичные поля, заметки по consistency — без построчного OpenAPI. Упомяните версионирование, если mobile отстаёт от сервера.

На интервью: три–пять core endpoint по промпту, idempotency для payment-подобных операций, пагинация для списков.

Типовые ошибки: chatty API с множеством round trip; нет idempotency на create/charge; неоднозначные ошибки для retry клиента.

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

Чеклист:

  • Перечислите core endpoint или события.
  • Отметьте идемпотентные и неидемпотентные записи.
  • Укажите пагинацию и auth по ресурсам.
  • Опишите ошибки, безопасные для retry.