Эти маршруты позволяют получить/создать/обновить/удалить комментарии.
Возможные маршруты (конечные точки маршрутов описаны ниже):
/wp/v2/comments // работает со всеми комментариями /wp/v2/comments/{ID} // работает с указанным вместо {ID} комментарием
Схема ресурса
Схема показывает все поля, которые существуют для объекта: поля объекта которые вернет запрос.
Параметр | Контекст | Описание |
---|---|---|
id число | view, edit, embed | ID комментария. Только для чтения. |
author число | view, edit, embed | Идентификатор (ID) автора комментария, если тот был авторизован. |
author_email строка | edit | Адрес электронной почты автора комментария. |
author_ip строка | edit | IP адрес автора комментария. |
author_name строка | view, edit, embed | Отображаемое имя автора комментария. |
author_url строка | view, edit, embed | Ссылка на сайт автора комментария. |
author_user_agent строка | edit | Юзер-агент автора комментария. |
content объект | view, edit, embed | Содержимое комментария. |
date строка | view, edit, embed | Дата публикации комментария в часовом поясе сайта. |
date_gmt строка/datetime | view, edit | Дата публикации комментария, как GMT. |
link строка | view, edit, embed | Ссылка на комментарий. Только для чтения. |
parent число | view, edit, embed | ID родительского комментария. |
post число | view, edit | ID записи, к которой оставлен комментарий. |
status строка | view, edit | Статус комментария (approve, spam и т.д.). |
type строка | view, edit, embed | Тип комментария. Только для чтения. |
author_avatar_urls объект | view, edit, embed | Ссылка на аватар автора комментария. Только для чтения. |
meta объект | view, edit | Метаполя комментария. |
Параметры запроса
- context
- Область, в которой выполняется запрос; определяет поля присутствующие в ответе.
Может быть: view, embed, edit
По умолчанию: view - page
- Текущая страница пагинации.
По умолчанию: 1 - per_page
- Максимальное число элементов, возвращаемых в результате.
По умолчанию: 10 - search
- Ограничьте результаты теми, которые соответствуют строке.
- after
- Ограничить ответ по комментариям, опубликованных после заданной даты, соответствующей ISO8601.
- before
- Ограничить ответ по комментариям, опубликованных до заданной даты, соответствующей ISO8601.
- author
- Указывает комментарии каких авторов (указывается их ID) надо вернуть. Требуется авторизация.
- author_exclude
- Указывает комментарии каких авторов (указывается их ID) не нужно возвращать. Требуется авторизация.
- author_email
- Указывает комментарии каких авторов (указывается их эл. почта) надо вернуть. Требуется авторизация.
- exclude
- Исключает комментарии по ID.
- include
- Показывает только указанные тут комментарии. Указывается ID.
- offset
- Смещение (отступ) набора результатов на указанное число.
- orderby
- По какому полю сортировать?
Может быть: date, date_gmt, id, include, post, parent, type
По умолчанию: date_gmt - order
- Как сортировать?
Может быть: asc, desc
По умолчанию: desc - status
- Ограничение выборки по одному статусу или нескольким. Требуется авторизация.
По умолчанию: approve - parent
- Ограничение выборки на основе ID родительского комментария или комментариев.
- parent_exclude
- Исключает из набора комментарии на основе ID родительского комментария или комментариев.
- post:
- Ограничение выборки на основе ID записи (или записей), к которой прикреплены комментарии.
- type
- Ограничить выборку на основе типа комментария. Требуется авторизация.
По умолчанию: comment - password
- Пароль для поста, если он защищен паролем.