hrbox-public/api
5
0
Fork 0
Code Issues Pull Requests 6 Actions Packages Projects Releases Wiki Activity

api-doc: уточнил формат created_at и др. date-range фильтров

Browse Source 
Алекс (sokolove) сообщил, что фильтр created_at в
/admin/wallet-transaction возвращает 422 при передаче значения
с временем суток. ValidationRules::ruleDateRange использует
format yyyy-MM-dd; время не поддерживается, формат значения —
yyyy-MM-dd|yyyy-MM-dd.

Обновлены формулировки описаний фильтров и полей схем:

- /user/index: created_at, last_login_at
- /admin/wallet: created_at
- /admin/wallet-transaction: created_at
- /admin/employment: created_at, employment_date, fired_date
- AdminEmployment schema: employment_date, fired_date

Везде явно указан формат yyyy-MM-dd. Для диапазонов добавлена
пометка, что указание времени суток не поддерживается.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Denis
2026-06-15 09:24:47 +03:00
co-authored by Claude Opus 4.7
parent 02e4440b68
commit bf13d71699
1 changed files with 23 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
v2/swagger.yaml
+23 -12
View File
@@ -691,13 +691,15 @@ paths:
in: query
schema: { type: string }
description: |
Период создания записи в формате `<начало>|<конец>`,
где даты указаны по ISO 8601.
Период создания записи в виде `<начало>|<конец>`,
где каждая дата задаётся в формате `yyyy-MM-dd`.
Указание времени суток не поддерживается.
- name: last_login_at
in: query
schema: { type: string }
description: |
Период последнего входа в систему в формате `<начало>|<конец>`.
Период последнего входа в систему в виде `<начало>|<конец>`,
где каждая дата задаётся в формате `yyyy-MM-dd`.
- name: user_list_key
in: query
schema: { type: string, format: uuid }
@@ -7226,7 +7228,10 @@ paths:
- name: created_at
in: query
schema: { type: string }
description: 'Диапазон в формате `from|to` (ISO дата/время).'
description: |
Диапазон в виде `<начало>|<конец>`, где каждая дата
задаётся в формате `yyyy-MM-dd`. Указание времени суток
не поддерживается.
responses:
200:
description: Список кошельков
@@ -7359,7 +7364,10 @@ paths:
- name: created_at
in: query
schema: { type: string }
description: 'Диапазон в формате `from|to` (ISO дата/время).'
description: |
Диапазон в виде `<начало>|<конец>`, где каждая дата
задаётся в формате `yyyy-MM-dd`. Указание времени суток
не поддерживается.
responses:
200:
description: Список транзакций
@@ -8149,18 +8157,21 @@ paths:
in: query
schema: { type: string }
description: |
Период создания записи в формате `<начало>|<конец>`,
где даты указаны по ISO 8601.
Период создания записи в виде `<начало>|<конец>`,
где каждая дата задаётся в формате `yyyy-MM-dd`.
Указание времени суток не поддерживается.
- name: employment_date
in: query
schema: { type: string }
description: |
Период даты приёма на работу в формате `<начало>|<конец>`.
Период даты приёма на работу в виде `<начало>|<конец>`,
где каждая дата задаётся в формате `yyyy-MM-dd`.
- name: fired_date
in: query
schema: { type: string }
description: |
Период даты увольнения в формате `<начало>|<конец>`.
Период даты увольнения в виде `<начало>|<конец>`,
где каждая дата задаётся в формате `yyyy-MM-dd`.
- name: user_list_key
in: query
schema: { type: string, format: uuid }
@@ -13651,13 +13662,13 @@ components:
employment_date:
type: string
nullable: true
description: Дата приёма на работу в формате ISO 8601.
description: Дата приёма на работу в формате `yyyy-MM-dd`.
fired_date:
type: string
nullable: true
description: |
Дата увольнения в формате ISO 8601. Поле имеет значение `null`
для действующих трудоустройств.
Дата увольнения в формате `yyyy-MM-dd`. Поле имеет значение
`null` для действующих трудоустройств.
status_id:
type: integer
nullable: true