intermediate
Проектирование REST API
Моделируйте resources, methods, status codes, pagination, filtering, versioning, idempotency, errors и OpenAPI contracts.
На интервью по REST API проверяют resource modeling, HTTP semantics, list operations, evolution, idempotency, error shape и OpenAPI как reviewed contract.
Подтемы: resources и methods, status codes, pagination/filtering/sorting, versioning/compatibility, idempotency, error response shape и OpenAPI.
На интервью: endpoints для domain noun, status codes для validation vs conflicts, safe retries на POST с idempotency keys.
Типовые ошибки: verbs в URL везде, 200 для errors, ломание list clients при смене sort, OpenAPI расходится с production.
Компромисс — между простотой, производительностью, безопасностью и эксплуатацией: назовите, что оптимизировали и какую цену приняли.
Чеклист:
- Nouns как resources с ясной method semantics.
- Status codes + machine-readable errors.
- Cursor pagination для больших mutable lists.
- Additive versioning; окна deprecation.