Загрузить multipart-данные в одну папку артефактов

PUT

/wp-json/wp2/media-converter/v1/attachments/{id}/artifacts/{folder}

curl --request PUT \
  --url https://example.com/wp-json/wp2/media-converter/v1/attachments/1/artifacts/sources \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --form files=@file \
  --form file=@file \
  --form srclang=example \
  --form label=example \
  --form default=example

Загружает файлы multipart в одну папку артефактов: sources, subtitles, chapters, thumbnails или stills.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Числовой идентификатор сущности.

folder

required

string

Allowed values: sources subtitles chapters thumbnails stills

Папка артефактов: sources, subtitles, chapters, thumbnails, stills.

Request Body^required

Media typemultipart/form-data

object

files

Карта относительных путей к содержимому файлов (строка).

Array<string>

file

Загружаемый файл (multipart).

string format: binary

srclang

Поле «srclang», как принимает или отдаёт PHP.

string

label

Подпись продукта.

string

default

Поле «default», как принимает или отдаёт PHP.

string

Responses

200

Перечень после загрузки папки, плюс accepted/rejected.

Media typeapplication/json

object

attachment_id

ID видеовложения.

integer

basename

Базовое имя ролика без расширения.

string

sources

Файлы в папке sources (HLS/MP4 и т.п.).

Array<object>

object

name

Имя файла относительно папки артефактов.

string

url

Публичный URL файла.

string

bytes

Размер файла в байтах.

integer

subtitles

Файлы субтитров на диске.

Array<object>

object

name

Имя файла относительно папки артефактов.

string

url

Публичный URL файла.

string

bytes

Размер файла в байтах.

integer

chapters

Файлы глав на диске.

Array<object>

object

name

Имя файла относительно папки артефактов.

string

url

Публичный URL файла.

string

bytes

Размер файла в байтах.

integer

thumbnails

Файлы спрайтов/VTT шкалы перемотки.

Array<object>

object

name

Имя файла относительно папки артефактов.

string

url

Публичный URL файла.

string

bytes

Размер файла в байтах.

integer

stills

Кадры-обложки (*_thumbN.jpg).

Array<object>

object

name

Имя файла относительно папки артефактов.

string

url

Публичный URL файла.

string

bytes

Размер файла в байтах.

integer

formats

Карта ключ формата → exists/url.

object

key

additional properties

object

exists

Файл этого формата уже есть на диске.

boolean

url

URL файла формата или пустая строка.

string

poster

URL постера из меты вложения (может быть пустым).

string

accepted

Файлы, которые PHP сохранил.

Array<object>

object

path

Относительный путь файла в запросе или ZIP.

string

reason

Код отказа (для rejected) или причина.

string

message

Текст ошибки сохранения файла.

string

name

Имя принятого файла (для accepted).

string

url

URL принятого файла (для accepted).

string

rejected

Файлы, которые PHP отклонил (имя, размер, HLS-лимит).

Array<object>

object

path

Относительный путь файла в запросе или ZIP.

string

reason

Код отказа (для rejected) или причина.

string

message

Текст ошибки сохранения файла.

string

name

Имя принятого файла (для accepted).

string

url

URL принятого файла (для accepted).

string

mode

Режим ZIP-пакета (только pack).

string

Allowed values: replace merge

touched

Папки, которые pack реально изменил.

Array<string>

Example

{
  "mode": "replace"
}

400

Проверка не пройдена (включая hls_segment_too_large)

Media typeapplication/json

object

code

Машинный код ошибки или события.

string

message

Текст сообщения (лог, PIN, сброс пароля).

string

data

Дополнительные данные WP_Error или лицензии.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}

401

Не аутентифицирован. WordPress REST: rest_not_logged_in / rest_forbidden. Cookie + X-WP-Nonce или Application Password.

Media typeapplication/json

object

code

Машинный код ошибки или события.

string

message

Текст сообщения (лог, PIN, сброс пароля).

string

data

Дополнительные данные WP_Error или лицензии.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}

403

Нет права или невалидный REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json

object

code

Машинный код ошибки или события.

string

message

Текст сообщения (лог, PIN, сброс пароля).

string

data

Дополнительные данные WP_Error или лицензии.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}