Качество API

На интервью по API quality — durability: backward compatibility, rate limits, auth boundaries, documentation, contract tests и signals для защиты consumers.

Подтемы: rate limits и API auth, documentation и contract testing.

На интервью: безопасный breaking change, throttle abusive clients, schema drift до production.

Типовые ошибки: docs отстают от code, consumer tests только на лживых mocks, global rate limits бьют по legitimate burst traffic.

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

Чеклист:

• Version/deprecate с измеримым impact на consumers.
• Scoped credentials, quotas, Retry-After.
• Examples, schemas и CI contract checks согласованы.
• Мониторинг per-consumer errors и latency budgets.