Медиа (media)

Эти маршруты позволяют получить/создать/обновить/удалить вложение (медиа).

Возможные маршруты (конечные точки маршрутов описаны ниже):

/wp/v2/media        // работает со всеми вложениями
/wp/v2/media/{ID}   // работает с указанной вместо {ID} вложением

/wp/v2/media/{ID}/post-process
/wp/v2/media/{ID}/edit

Схема ресурса

Схема показывает все поля, которые существуют для объекта запись: поля объекта которые вернет запрос.

Параметр	Контекст	Описание
date Строка/null	view, edit, embed	Дата публикации объекта, по временной зоне сайта.
date_gmt Строка/null	view, edit	Время публикации объекта, по GMT.
guid Объект readonly	view, edit	Глобальный уникальный идентификатор для объекта.
id Число readonly	view, edit, embed	Уникальный идентификатор для объекта.
link Строка readonly	view, edit, embed	URL объекта.
modified Строка readonly	view, edit	Дата последнего изменения объекта, по временной зоне сайта.
modified_gmt Строка readonly	view, edit	Дата последнего изменения объекта, в GMT.
slug Строка	view, edit, embed	Буквенно-цифровой идентификатор для объекта уникальный для его типа.
status Строка	view, edit	Именованный статус для объекта.
type Строка readonly	view, edit, embed	Тип записи для объекта.
permalink_template Строка readonly	edit	Шаблон постоянных ссылок для объекта.
generated_slug Строка readonly	edit	Ярлык автоматически создан из заголовка объекта.
title Объект	view, edit, embed	Название для объекта.
author Число	view, edit, embed	ID автора объекта.
comment_status Строка	view, edit	Открыты ли комментарии для объекта.
ping_status Строка	view, edit	Принимает ли объект уведомления.
meta Объект	view, edit	Мета поля.
template Строка	view, edit	Файл темы используемый для показа объекта.
alt_text Строка	view, edit, embed	Альтернативный текст для показа когда вложение не отображается.
caption Объект	view, edit, embed	Подпись вложения.
description Объект	view, edit	Описание вложения.
media_type Строка readonly	view, edit, embed	Тип вложения.
mime_type Строка readonly	view, edit, embed	MIME тип вложения.
media_details Объект readonly	view, edit, embed	Подробности о медиа файле, специфичные его типу.
post Число	view, edit	ID для ассоциированых записей для вложения.
source_url Строка readonly	view, edit, embed	URL оригинала файла вложения.
missing_image_sizes Массив readonly	edit	Список отсутствующих размеров изображений для вложения.

Список всех вложений

Алгоритм схож с работой функции get_posts(), где для каждого объекта вложения добавлены специфические свойства.

Вид запроса

Доступ: публичный

GET /wp/v2/media

Параметры запроса

context

Область, в которой выполняется запрос; определяет поля, присутствующие в ответе. Может быть view, embed, edit.
По умолчанию: view

page

Текущая страница коллекции.
По умолчанию: 1

per_page

Максимальное количество вложений в результирующем наборе.
По умолчанию: 10

search

Ограничение по количеству возвращаемых записей при поиске.

after

Ограничить ответ по вложениям, опубликованных после заданной даты, соответствующей ISO8601.

before

Ограничить ответ по вложениям, опубликованных до заданной даты, соответствующей ISO8601.

exclude

Исключает из набора вложения по их ID.

include

Включает в набор вложения по их ID. В наборе будут присутствовать только те вложения, ID которых были указаны.

offset

Смещение (отступ) набора результатов на указанное число.
По умолчанию: 1

order

Сортировка вложений в выборке. Может быть asc или desc.
По умолчанию: desc

orderby

Сортировка записей в выборке по атрибутам. Может быть author, date, id, include, modified, parent, relevance, slug, title.
По умолчанию: date

parent

Ограничить выборку до определенных ID родителей.

parent_exclude

Ограничить выборку до объектов за исключением имеющих определенный ID родителя.

slug

Ограничение выборки по указанному одному ярлыку вложения или нескольким.

status

Ограничение выборки по одному статусу или нескольким.
По умолчанию: inherit

media_type

Ограничить выборку до вложений определенного типа медиа. Может быть: image, video, audio, application

mime_type

Ограничить выборку до вложений определенного MIME типа.