Merge branch 'feature/api-doc-date-format' into 'master'

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

See merge request hrbox-public/api!40

v2/swagger.yaml

@@ -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