5.1 KiB
Spec Delta
MODIFIED Requirements
Requirement: Соответствие статусов и кодов ошибок
Сервис SHALL использовать пары статус — code: 400 —
invalid_request, 401 — unauthorized, 404 — not_found, 409 —
conflict, 413 — payload_too_large, 415 — unsupported_media_type,
500 — internal_error, 503 — unavailable. Метод, не поддерживаемый
путём, SHALL давать 405 с code invalid_request.
Scenario: Неизвестный путь
- WHEN клиент запрашивает
GET /api/v1/unknown - THEN ответ 404 с
codenot_foundв формате ошибки
Scenario: Неподдерживаемый метод
- WHEN клиент выполняет
DELETE /api/v1/users - THEN ответ 405 с
codeinvalid_requestв формате ошибки
Scenario: Лимит и тип вложения
- WHEN участник загружает вложение больше 10 MiB, а затем текст с
Content-Type: image/png - THEN ответы 413 с
codepayload_too_largeи 415 сcodeunsupported_media_typeв формате ошибки
Requirement: UUID на входе
Идентификатор, который передаёт клиент, SHALL приниматься только как
строка UUID в записи 8-4-4-4-12 (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx),
как format: uuid контракта. Это chat_id и с лабы 4
attachment_id в пути, элементы member_ids и с лабы 4 элементы
attachment_ids в теле. Шестнадцатеричные цифры SHALL приниматься в
любом регистре: UUID в верхнем регистре обозначает тот же
идентификатор, что в нижнем. В ответах идентификаторы остаются в нижнем
регистре (требование «Представление времени и идентификаторов»).
Значение другого типа (массив, объект, число, логическое значение, null)
и строка в другой записи (без дефисов, с префиксом urn:uuid:, в
фигурных скобках, с пробелами) SHALL давать 400 invalid_request, а не
500 и не успешный ответ. Такой запрос MUST NOT создавать объектов.
Scenario: UUID другого типа в теле
- WHEN Алиса создаёт чат, где
member_idsсодержит её id и ещё один элемент —[],{},123илиfalse - THEN ответ 400 с
codeinvalid_request, чат не появился в списке чатов Алисы
Scenario: Не UUID в пути
- WHEN пользователь с действующей сессией запрашивает чат, историю
чата или отправляет сообщение с верным
Idempotency-Key, аchat_idв пути равен123,false,[]или{} - THEN ответ 400 с
codeinvalid_request
Scenario: Другая запись UUID
- WHEN участник передаёт id своего чата в пути или Алиса передаёт id
Боба в
member_ids, записанный без дефисов, с префиксомurn:uuid:или в фигурных скобках - THEN ответ 400 с
codeinvalid_request; ни чата, ни сообщения не создано
Scenario: UUID в верхнем регистре в пути
- WHEN участник запрашивает свой чат, его историю и отправляет в
него сообщение, записав
chat_idв верхнем регистре - THEN ответы те же, что для
chat_idв нижнем регистре, аidиchat_idв них — в нижнем регистре
Scenario: Идентификаторы вложений в другой записи
- WHEN участник запрашивает метаданные и байты вложения, записав
attachment_idбез дефисов, с префиксомurn:uuid:или в фигурных скобках, и отправляет сообщение с таким элементом вattachment_ids - THEN каждый ответ 400 с
codeinvalid_request, сообщение не создано
Scenario: Идентификаторы вложений в верхнем регистре
- WHEN участник запрашивает метаданные и байты вложения и отправляет сообщение с ним, записав id вложения в верхнем регистре
- THEN ответы те же, что для id в нижнем регистре, а
idиattachment_idsв них — в нижнем регистре