38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
## 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` —
|
||
положительным целым числом
|