intermediate

Проектирование API

Проектируйте HTTP, GraphQL, realtime, RPC, webhook и event-driven API contracts, которые удобны, развиваемы и observable.

На интервью по API design оценивают contracts: usable, evolvable, observable — REST, GraphQL, realtime, RPC, webhooks и quality practices, а не только стиль.

Дочерние разделы: REST API design, GraphQL, realtime/streaming, RPC/gRPC/tRPC, webhooks/event-driven APIs и API quality.

На интервью: для фичи выберите API style, обоснуйте trade-offs и опишите versioning, errors, auth и operational signals.

Типовые ошибки: GraphQL для простого CRUD без N+1, REST без idempotency для payments, realtime без reconnect, public API без contract tests.

Чеклист:

  • API style под clients, coupling и scale.
  • Явные errors, pagination и versioning.
  • Auth, rate limits и documentation вместе.
  • Instrumentation для SLOs и поломок consumers.