feat(uploads): preview storage paths, detect templates, attach covers and withdraw batches

api/openapi.yaml

@@ -910,6 +910,12 @@ paths:
       tags: [uploads]
       summary: Мои предложения (moderator, admin)
       parameters:
+        - name: batch
+          in: query
+          description: Только файлы указанной собственной пачки
+          schema:
+            type: string
+            format: uuid
         - $ref: "#/components/parameters/UploadStatusFilter"
         - $ref: "#/components/parameters/Limit"
         - $ref: "#/components/parameters/Cursor"
@@ -2743,6 +2749,10 @@ components:
       type: object
       required: [files]
       properties:
+        cover_base64:
+          type: string
+          maxLength: 11184812
+          description: Обложка альбома JPEG, PNG или WebP, до 8 МБ после декодирования. Применяется ко всем файлам пачки.
         comment:
           type: string
           maxLength: 1000
@@ -2914,6 +2924,10 @@ components:
           type: string
           nullable: true
           description: Путь в хранилище по write_template (null — не построился, причина в status_reason)
+        target_source_name:
+          type: string
+          nullable: true
+          description: Название целевого хранилища; null, если хранилище не выбрано или удалено
         status_reason:
           type: string
           nullable: true
@@ -3614,6 +3628,17 @@ components:
       properties:
         template:
           type: string
+        matched:
+          type: integer
+          description: Число путей выборки, совпавших с предложенным шаблоном
+        total:
+          type: integer
+          description: Число исследованных файлов хранилища
+        examples:
+          type: array
+          items:
+            type: string
+          description: До трёх существующих путей, совпавших с шаблоном
     WriteTemplateCheckRequest:
       type: object
       required: [template]