Установить изображение постера

PUT

/wp-json/wp2/media-converter/v1/attachments/{id}/thumbnails/poster

curl --request PUT \
  --url https://example.com/wp-json/wp2/media-converter/v1/attachments/1/thumbnails/poster \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "attachment_id": 1, "url": "example", "set_featured": true }'

Назначает файл постера для плеера (загрузка изображения, не автогенерация кадра).

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

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

Request Body

object

attachment_id

ID вложения медиатеки.

integer

url

URL.

string format: uri

set_featured

Назначить загруженный файл миниатюрой записи.

boolean

Example

{
  "attachment_id": 1,
  "url": "example",
  "set_featured": true
}

object

file

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

string format: binary

Responses

200

Media typeapplication/json

object

attachment_id

ID вложения медиатеки.

integer

poster

Текущий постер вложения.

object

attachment_id

ID вложения-постера или null.

integer

nullable

url

URL постера или null.

string

nullable

featured_id

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

integer

nullable

thumbnails

Сгенерированные дочерние миниатюры.

Array<object>

object

attachment_id

ID вложения-миниатюры.

integer

url

URL миниатюры.

string

Example^generated

{
  "attachment_id": 1,
  "poster": {
    "attachment_id": 1,
    "url": "example"
  },
  "featured_id": 1,
  "thumbnails": [
    {
      "attachment_id": 1,
      "url": "example"
    }
  ]
}

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