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

38 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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` —
положительным целым числом