Перейти к содержимому

Загрузить ZIP-пакет артефактов воспроизведения для указанного вложения

POST
/wp-json/wp2/media-converter/v1/attachments/{id}/artifacts/pack
curl --request POST \
--url https://example.com/wp-json/wp2/media-converter/v1/attachments/1/artifacts/pack \
--header 'Content-Type: multipart/form-data' \
--header 'X-WP-Nonce: <X-WP-Nonce>' \
--form pack=@file \
--form mode=replace

Принимает ZIP с деревом артефактов (корни sources/, subtitles/, chapters/, thumbnails/ и кадры *_thumbN.jpg в корне). mode=replace полностью заменяет папки, merge дополняет. Сегменты HLS .ts больше лимита попадают в rejected.

id
required
integer

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

Media typemultipart/form-data
object
pack
required

Содержимое ZIP-пакета артефактов.

string format: binary
mode

Режим (подключения, replace, pack).

string
default: replace
Allowed values: replace merge

Перечень после pack, плюс accepted/rejected/mode/touched.

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"
}

Недопустимый ZIP-архив, имя или слишком большой сегмент

Media typeapplication/json
object
code

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

string
message

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

string
data

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

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

Не аутентифицирован. 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
Examplegenerated
{
"code": "example",
"message": "example",
"data": {}
}

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

Media typeapplication/json
object
code

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

string
message

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

string
data

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

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