From 940577d8cd17ee18a4fdeb48da252524c12bd66e Mon Sep 17 00:00:00 2001 From: Leonid Pershin Date: Tue, 14 Jul 2026 23:32:08 +0300 Subject: [PATCH] Update API documentation for role selection endpoint to clarify response structure - Modified the response description for the `/api/support/roles` GET endpoint to specify that the returned `RoleDto[]` excludes both the current user's role and admin roles, enhancing clarity for developers using the API. --- docs/api-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-design.md b/docs/api-design.md index 4f83709..5a940b6 100644 --- a/docs/api-design.md +++ b/docs/api-design.md @@ -155,7 +155,7 @@ status, createdAt }`. `expiresAt` всегда `null` (лимиты по сро | Метод | Путь | Тело запроса | Тело ответа | | ----- | ----------------------------------------- | ---------------------------------------------------------------------------- | ------------- | -| GET | `/api/support/roles` | — | `RoleDto[]` (без `admin`) — для выбора существующей роли в заявке | +| GET | `/api/support/roles` | — | `RoleDto[]` (без `admin` и без текущей роли пользователя) — для выбора существующей роли в заявке | | GET | `/api/support/tickets` | query: `type?, status?, page=1, pageSize=20` | `PagedList` (только свои) | | GET | `/api/support/tickets/{id}` | — | `TicketDetailDto` (404, если не свой) | | POST | `/api/support/tickets/bug-reports` | multipart: `message` + `files[]` (до 5, изображения до 5 МБ) | `TicketDetailDto` |