Files
mtusi2026lab4/openspec/changes/upload-memory/specs/api-conventions/spec.md
T
2026-10-21 23:21:42 +03:00

1.9 KiB
Raw Blame History

MODIFIED Requirements

Requirement: Соответствие статусов и кодов ошибок

Сервис SHALL использовать пары статус — code: 400 — invalid_request, 401 — unauthorized, 404 — not_found, 409 — conflict, 413 — payload_too_large, 415 — unsupported_media_type, 429 — rate_limited, 500 — internal_error, 503 — unavailable. Метод, не поддерживаемый путём, SHALL давать 405 с code invalid_request. Ответ 429 SHALL содержать заголовок Retry-After — положительное целое число секунд.

Scenario: Неизвестный путь

  • WHEN клиент запрашивает GET /api/v1/unknown
  • THEN ответ 404 с code not_found в формате ошибки

Scenario: Неподдерживаемый метод

  • WHEN клиент выполняет DELETE /api/v1/users
  • THEN ответ 405 с code invalid_request в формате ошибки

Scenario: Лимит и тип вложения

  • WHEN участник загружает вложение больше 10 MiB, а затем текст с Content-Type: image/png
  • THEN ответы 413 с code payload_too_large и 415 с code unsupported_media_type в формате ошибки

Scenario: Лимит одновременных загрузок

  • WHEN все места загрузки процесса заняты и очередь ожидания полна (attachments, «Одновременные загрузки реплики»), и участник загружает вложение
  • THEN ответ 429 с code rate_limited в формате ошибки, с непустыми X-Request-Id и X-Instance-Id и с Retry-After — положительным целым числом