WordPress как на ладони
Новые WordPress шаблоны Хостинг, VPS/VDS и отдельные сервера только на SSD дисках. 7 дней бесплатного тестирования.

Пользователи

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

Возможные маршруты:

/wp/v2/users       // работает со всеми юзерами
/wp/v2/users/{ID}  // работает с указанным вместо {ID} юзером

Ниже описаны разные конечные точки для этих маршрутов.

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

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

Параметр Контекст Описание
id
число
view, edit, embed Уникальный идентификатор пользователя.
Только для чтения.
username
строка
edit Имя пользователя для входа.
Обязательный.
name
строка
view, edit, embed Отображаемое имя пользователя.
first_name
строка
edit Имя пользователя.
last_name
строка
edit Фамилия пользователя.
email
строка
edit E-mail пользователя.
Обязательный.
url
строка
view, edit, embed URL пользователя.
description
строка
view, edit, embed Описание пользователя (биография).
link
строка
view, edit, embed URL на страницу записей пользователя.
Только для чтения.
locale
строка
edit Локаль пользователя.
Может быть: '', en_US, ru_RU, uk.
nickname
строка
edit Ник пользователя.
slug
строка
view, edit, embed Ярлык (ID) пользователя.
registered_date
строка
edit Дата регистрации пользователя.
Только для чтения.
roles
массив
edit Роли пользователя. В виде значений ролей (строк) в массиве.
password
строка
- Пароль пользователя (никогда не показывается).
capabilities
объект
edit Все возможности пользователя.
Только для чтения.
extra_capabilities
объект
edit Любые дополнительные возможности пользователя.
Только для чтения.
avatar_urls
объект
view, edit, embed URL аватара пользователя. Содержит объект с ссылками на разные размеры аватара: 24, 48, 96 px.
Только для чтения.
meta
объект
view, edit Мета поля пользователя.
меню

wp/v2/users

Запрос OPTIONS к маршруту вернет полное описание этого маршрута: эндпоинты их параметры, схему.

$ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/users
{
    "namespace": "wp/v2",
    "methods": [
        "GET",
        "POST"
    ],
    "endpoints": [
        {
            "methods": [
                "GET"
            ],
            "args": {
                "context": {
                    "required": false,
                    "default": "view",
                    "enum": [
                        "view",
                        "embed",
                        "edit"
                    ],
                    "description": "Рамки в которых сделан запрос, определяют поля в ответе.",
                    "type": "string"
                },
                "page": {
                    "required": false,
                    "default": 1,
                    "description": "Текущая страница коллекции.",
                    "type": "integer"
                },
                "per_page": {
                    "required": false,
                    "default": 10,
                    "description": "Максимальное число объектов возвращаемое в выборке.",
                    "type": "integer"
                },
                "search": {
                    "required": false,
                    "description": "Ограничить результаты до совпадающих со строкой.",
                    "type": "string"
                },
                "exclude": {
                    "required": false,
                    "default": [],
                    "description": "Убедиться что выборка исключает определенные ID.",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "include": {
                    "required": false,
                    "default": [],
                    "description": "Ограничить выборку до определенных ID.",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "offset": {
                    "required": false,
                    "description": "Сдвиг выборки на определенное число объектов.",
                    "type": "integer"
                },
                "order": {
                    "required": false,
                    "default": "asc",
                    "enum": [
                        "asc",
                        "desc"
                    ],
                    "description": "Упорядочить сортировку атрибута по возрастанию или убыванию.",
                    "type": "string"
                },
                "orderby": {
                    "required": false,
                    "default": "name",
                    "enum": [
                        "id",
                        "include",
                        "name",
                        "registered_date",
                        "slug",
                        "include_slugs",
                        "email",
                        "url"
                    ],
                    "description": "Сортировать коллекцию по атрибуту объекта.",
                    "type": "string"
                },
                "slug": {
                    "required": false,
                    "description": "Ограничить выборку пользователями с одним или более специальными ярлыками.",
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "roles": {
                    "required": false,
                    "description": "Ограничить выборку до пользователей удовлетворяющих как минимум одной указанной роли. Можно указать CSV список или одну роль.",
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "who": {
                    "required": false,
                    "enum": [
                        "authors"
                    ],
                    "description": "Ограничить выборку пользователями-авторами.",
                    "type": "string"
                }
            }
        },
        {
            "methods": [
                "POST"
            ],
            "args": {
                "username": {
                    "required": true,
                    "description": "Имя входа для пользователя.",
                    "type": "string"
                },
                "name": {
                    "required": false,
                    "description": "Отображаемое имя пользователя.",
                    "type": "string"
                },
                "first_name": {
                    "required": false,
                    "description": "Имя пользователя.",
                    "type": "string"
                },
                "last_name": {
                    "required": false,
                    "description": "Фамилия пользователя.",
                    "type": "string"
                },
                "email": {
                    "required": true,
                    "description": "Адрес e-mail пользователя.",
                    "type": "string"
                },
                "url": {
                    "required": false,
                    "description": "URL пользователя.",
                    "type": "string"
                },
                "description": {
                    "required": false,
                    "description": "Описание пользователя.",
                    "type": "string"
                },
                "locale": {
                    "required": false,
                    "enum": [
                        "",
                        "en_US",
                        "ru_RU",
                        "uk"
                    ],
                    "description": "Локаль для пользователя.",
                    "type": "string"
                },
                "nickname": {
                    "required": false,
                    "description": "Ник пользователя.",
                    "type": "string"
                },
                "slug": {
                    "required": false,
                    "description": "Буквенно-цифровой идентификатор пользователя.",
                    "type": "string"
                },
                "roles": {
                    "required": false,
                    "description": "Роли назначенные пользователю.",
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "password": {
                    "required": true,
                    "description": "Пароль пользователя (никогда не показывается).",
                    "type": "string"
                },
                "meta": {
                    "required": false,
                    "description": "Мета поля.",
                    "type": "object"
                }
            }
        }
    ],
    "schema": {
        "$schema": "http://json-schema.org/draft-04/schema#",
        "title": "user",
        "type": "object",
        "properties": {
            "id": {
                "description": "Уникальный идентификатор пользователя.",
                "type": "integer",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true
            },
            "username": {
                "description": "Имя входа для пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ],
                "required": true
            },
            "name": {
                "description": "Отображаемое имя пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "first_name": {
                "description": "Имя пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "last_name": {
                "description": "Фамилия пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "email": {
                "description": "Адрес e-mail пользователя.",
                "type": "string",
                "format": "email",
                "context": [
                    "edit"
                ],
                "required": true
            },
            "url": {
                "description": "URL пользователя.",
                "type": "string",
                "format": "uri",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "description": {
                "description": "Описание пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "link": {
                "description": "URL автора для пользователя.",
                "type": "string",
                "format": "uri",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true
            },
            "locale": {
                "description": "Локаль для пользователя.",
                "type": "string",
                "enum": [
                    "",
                    "en_US",
                    "ru_RU",
                    "uk"
                ],
                "context": [
                    "edit"
                ]
            },
            "nickname": {
                "description": "Ник пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "slug": {
                "description": "Буквенно-цифровой идентификатор пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "registered_date": {
                "description": "Дата регистрации пользователя.",
                "type": "string",
                "format": "date-time",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "roles": {
                "description": "Роли назначенные пользователю.",
                "type": "array",
                "items": {
                    "type": "string"
                },
                "context": [
                    "edit"
                ]
            },
            "password": {
                "description": "Пароль пользователя (никогда не показывается).",
                "type": "string",
                "context": [],
                "required": true
            },
            "capabilities": {
                "description": "Все возможности назначенные пользователю.",
                "type": "object",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "extra_capabilities": {
                "description": "Любые дополнительные возможности назначенные пользователю.",
                "type": "object",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "avatar_urls": {
                "description": "URL аватара пользователя.",
                "type": "object",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true,
                "properties": {
                    "24": {
                        "description": "URL аватары с размером изображения в 24 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    },
                    "48": {
                        "description": "URL аватары с размером изображения в 48 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    },
                    "96": {
                        "description": "URL аватары с размером изображения в 96 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    }
                }
            },
            "meta": {
                "description": "Мета поля.",
                "type": "object",
                "context": [
                    "view",
                    "edit"
                ],
                "properties": []
            }
        }
    },
    "_links": {
        "self": "http://wptest.ru/wp-json/wp/v2/users"
    }
}
меню

Список юзеров

Алгоритм схож с работой функции get_users().

Вид запроса

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

GET /wp/v2/users

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

context(string)
Рамки в которых сделан запрос, определяют поля в ответе.
Может быть: view, embed, edit.
По умолчанию: view
page(integer)
Текущая страница коллекции.
По умолчанию: 1
per_page(integer)
Максимальное число объектов возвращаемое в выборке.
По умолчанию: 10
search(string)
Ограничить результаты до совпадающих со строкой.
exclude(array)
Исключить из выборки определенные ID. Указывается массив ID.
По умолчанию: []
include(array)
Ограничить выборку до определенных ID. Указывается массив ID.
По умолчанию: []
offset(integer)
Сдвиг выборки на определенное число объектов.
order(string)
Сортировать по возрастанию (asc) или убыванию (desc).
Может быть: asc, desc
По умолчанию: asc
orderby(string)
Поле по которому нужно сортировать коллекцию.
Может быть: id, include, name, registered_date, slug, include_slugs, email, url.
По умолчанию: name
slug(array)
Ярлык пользователя которого нужно получить. Можно указать несколько ярлыков в массиве.
roles(array)
Получить пользователй с указанной ролью. Можно указать несколько ролей в массиве. Можно указать CSV список или одну роль.
who(string)
Ограничить выборку пользователями-авторами.
Может быть: authors.

Пример запроса

$ curl http://demo.wp-api.org/wp-json/wp/v2/users?search=human

Ответ:

[
	{
		"id": 1,
		"name": "Human Made",
		"url": "",
		"description": "",
		"link": "https://demo.wp-api.org/author/humanmade/",
		"slug": "humanmade",
		"avatar_urls": {
			"24": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=24&d=mm&r=g",
			"48": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=48&d=mm&r=g",
			"96": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=96&d=mm&r=g"
		},
		"meta": [],
		"_links": {
			"self": [
				{
					"href": "https://demo.wp-api.org/wp-json/wp/v2/users/1"
				}
			],
			"collection": [
				{
					"href": "https://demo.wp-api.org/wp-json/wp/v2/users"
				}
			]
		}
	},
	{ ... }
]
меню

Создание юзера

Алгоритм схож с работой функции wp_create_user().

Вид запроса

Доступ: нужна авторизация

POST /wp/v2/users

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

username(строка) (обязательный)
Имя входа для пользователя.
email(строка) (обязательный)
Адрес e-mail пользователя.
password(строка) (обязательный)
Пароль пользователя (никогда не показывается).
name(строка)
Отображаемое имя пользователя.
first_name(строка)
Имя пользователя.
last_name(строка)
Фамилия пользователя.
url(строка)
URL пользователя.
description(строка)
Описание пользователя.
locale(строка)
Локаль для пользователя. Может быть: '', en_US, ru_RU, uk.
nickname(строка)
Ник пользователя.
slug(строка)
Буквенно-цифровой идентификатор пользователя.
roles(массив)
Роли назначенные пользователю. Указывается массив ролей.
meta(объект)
Мета поля.

Пример запроса

$ curl -X POST -i http://wptest.ru/wp-json/wp/v2/users?username=neuser&email=asd@asd.ru&password=123456

Ответ:

{
	"id": 2,
	"username": "neuser",
	"name": "neuser",
	"first_name": "",
	"last_name": "",
	"email": "asd@asd.ru",
	"url": "",
	"description": "",
	"link": "http://wptest.ru/author/neuser/",
	"locale": "ru_RU",
	"nickname": "neuser",
	"slug": "neuser",
	"roles": [
		"subscriber"
	],
	"registered_date": "2018-08-31T13:36:18+00:00",
	"capabilities": {
		"read": true,
		"level_0": true,
		"subscriber": true
	},
	"extra_capabilities": {
		"subscriber": true
	},
	"avatar_urls": {
		"24": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=24&d=mm&r=g",
		"48": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=48&d=mm&r=g",
		"96": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=96&d=mm&r=g"
	},
	"meta": [],
	"_links": {
		"self": [
			{
				"href": "http://wptest.ru/wp-json/wp/v2/users/2"
			}
		],
		"collection": [
			{
				"href": "http://wptest.ru/wp-json/wp/v2/users"
			}
		]
	}
}
меню

wp/v2/users/{ID}

Запрос OPTIONS к маршруту вернет полное описание этого маршрута: эндпоинты их параметры, схему.

$ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/users/{ID}
{
    "namespace": "wp/v2",
    "methods": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
    ],
    "endpoints": [
        {
            "methods": [
                "GET"
            ],
            "args": {
                "id": {
                    "required": false,
                    "description": "Уникальный идентификатор пользователя.",
                    "type": "integer"
                },
                "context": {
                    "required": false,
                    "default": "view",
                    "enum": [
                        "view",
                        "embed",
                        "edit"
                    ],
                    "description": "Рамки в которых сделан запрос, определяют поля в ответе.",
                    "type": "string"
                }
            }
        },
        {
            "methods": [
                "POST",
                "PUT",
                "PATCH"
            ],
            "args": {
                "id": {
                    "required": false,
                    "description": "Уникальный идентификатор пользователя.",
                    "type": "integer"
                },
                "username": {
                    "required": false,
                    "description": "Имя входа для пользователя.",
                    "type": "string"
                },
                "name": {
                    "required": false,
                    "description": "Отображаемое имя пользователя.",
                    "type": "string"
                },
                "first_name": {
                    "required": false,
                    "description": "Имя пользователя.",
                    "type": "string"
                },
                "last_name": {
                    "required": false,
                    "description": "Фамилия пользователя.",
                    "type": "string"
                },
                "email": {
                    "required": false,
                    "description": "Адрес e-mail пользователя.",
                    "type": "string"
                },
                "url": {
                    "required": false,
                    "description": "URL пользователя.",
                    "type": "string"
                },
                "description": {
                    "required": false,
                    "description": "Описание пользователя.",
                    "type": "string"
                },
                "locale": {
                    "required": false,
                    "enum": [
                        "",
                        "en_US",
                        "ru_RU",
                        "uk"
                    ],
                    "description": "Локаль для пользователя.",
                    "type": "string"
                },
                "nickname": {
                    "required": false,
                    "description": "Ник пользователя.",
                    "type": "string"
                },
                "slug": {
                    "required": false,
                    "description": "Буквенно-цифровой идентификатор пользователя.",
                    "type": "string"
                },
                "roles": {
                    "required": false,
                    "description": "Роли назначенные пользователю.",
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "password": {
                    "required": false,
                    "description": "Пароль пользователя (никогда не показывается).",
                    "type": "string"
                },
                "meta": {
                    "required": false,
                    "description": "Мета поля.",
                    "type": "object"
                }
            }
        },
        {
            "methods": [
                "DELETE"
            ],
            "args": {
                "id": {
                    "required": false,
                    "description": "Уникальный идентификатор пользователя.",
                    "type": "integer"
                },
                "force": {
                    "required": false,
                    "default": false,
                    "description": "Должно быть истинным, так как пользователей нельзя переместить в корзину.",
                    "type": "boolean"
                },
                "reassign": {
                    "required": true,
                    "description": "Переназначить удаленные записи пользователя и ссылки на этот ID пользователя.",
                    "type": "integer"
                }
            }
        }
    ],
    "schema": {
        "$schema": "http://json-schema.org/draft-04/schema#",
        "title": "user",
        "type": "object",
        "properties": {
            "id": {
                "description": "Уникальный идентификатор пользователя.",
                "type": "integer",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true
            },
            "username": {
                "description": "Имя входа для пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ],
                "required": true
            },
            "name": {
                "description": "Отображаемое имя пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "first_name": {
                "description": "Имя пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "last_name": {
                "description": "Фамилия пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "email": {
                "description": "Адрес e-mail пользователя.",
                "type": "string",
                "format": "email",
                "context": [
                    "edit"
                ],
                "required": true
            },
            "url": {
                "description": "URL пользователя.",
                "type": "string",
                "format": "uri",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "description": {
                "description": "Описание пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "link": {
                "description": "URL автора для пользователя.",
                "type": "string",
                "format": "uri",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true
            },
            "locale": {
                "description": "Локаль для пользователя.",
                "type": "string",
                "enum": [
                    "",
                    "en_US",
                    "ru_RU",
                    "uk"
                ],
                "context": [
                    "edit"
                ]
            },
            "nickname": {
                "description": "Ник пользователя.",
                "type": "string",
                "context": [
                    "edit"
                ]
            },
            "slug": {
                "description": "Буквенно-цифровой идентификатор пользователя.",
                "type": "string",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ]
            },
            "registered_date": {
                "description": "Дата регистрации пользователя.",
                "type": "string",
                "format": "date-time",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "roles": {
                "description": "Роли назначенные пользователю.",
                "type": "array",
                "items": {
                    "type": "string"
                },
                "context": [
                    "edit"
                ]
            },
            "password": {
                "description": "Пароль пользователя (никогда не показывается).",
                "type": "string",
                "context": [],
                "required": true
            },
            "capabilities": {
                "description": "Все возможности назначенные пользователю.",
                "type": "object",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "extra_capabilities": {
                "description": "Любые дополнительные возможности назначенные пользователю.",
                "type": "object",
                "context": [
                    "edit"
                ],
                "readonly": true
            },
            "avatar_urls": {
                "description": "URL аватара пользователя.",
                "type": "object",
                "context": [
                    "embed",
                    "view",
                    "edit"
                ],
                "readonly": true,
                "properties": {
                    "24": {
                        "description": "URL аватары с размером изображения в 24 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    },
                    "48": {
                        "description": "URL аватары с размером изображения в 48 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    },
                    "96": {
                        "description": "URL аватары с размером изображения в 96 пикселей.",
                        "type": "string",
                        "format": "uri",
                        "context": [
                            "embed",
                            "view",
                            "edit"
                        ]
                    }
                }
            },
            "meta": {
                "description": "Мета поля.",
                "type": "object",
                "context": [
                    "view",
                    "edit"
                ],
                "properties": []
            }
        }
    }
}
меню

Получение юзера

Алгоритм схож с работой функции get_userdata().

Вид запроса

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

GET /wp/v2/users/{id}

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

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

Пример запроса

$ curl http://demo.wp-api.org/wp-json/wp/v2/users/1
{
	"id": 1,
	"name": "Human Made",
	"url": "",
	"description": "",
	"link": "https://demo.wp-api.org/author/humanmade/",
	"slug": "humanmade",
	"avatar_urls": {
		"24": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=24&d=mm&r=g",
		"48": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=48&d=mm&r=g",
		"96": "http://2.gravatar.com/avatar/83888eb8aea456e4322577f96b4dbaab?s=96&d=mm&r=g"
	},
	"meta": [],
	"_links": {
		"self": [
			{
				"href": "https://demo.wp-api.org/wp-json/wp/v2/users/1"
			}
		],
		"collection": [
			{
				"href": "https://demo.wp-api.org/wp-json/wp/v2/users"
			}
		]
	}
}
меню

Обновление юзера

Алгоритм схож с работой функции wp_update_user().

Вид запроса

Доступ: нужна авторизация

POST|PUT|PATCH /wp/v2/users/{id}

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

username(строка)
Имя входа для пользователя.
name(строка)
Отображаемое имя пользователя.
first_name(строка)
Имя пользователя.
last_name(строка)
Фамилия пользователя.
email(строка)
Адрес e-mail пользователя.
url(строка)
URL пользователя на страницу постов.
description(строка)
Описание пользователя.
locale(строка)
Локаль для пользователя. Может быть: '', en_US, ru_RU, uk.
nickname(строка)
Ник пользователя.
slug(строка)
Ярлык пользователя.
roles(массив)
Роли назначенные пользователю. Массив строк.
password(строка)
Пароль пользователя (никогда не показывается).
meta(объект)
Мета поля.

Пример запроса

$ curl -X POST http://demo.wp-api.org/wp-json/wp/v2/users/2?email=foo@bar.com
меню

Удаление юзера

Алгоритм схож с работой функции wp_delete_user().

Вид запроса

Доступ: нужна авторизация

DELETE /wp/v2/users/{id}

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

force(true/false)
Всегда должно быть true, так как пользователей нельзя переместить в корзину.
По умолчанию: false
reassign(число) (обязательный)
ID пользователя на которого нужно перекинуть все посты и ссылки, удаляемого пользователя. Если не указать этот параметр, то все посты удаляемого пользователя будут также удалены.

Пример запроса

$ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/users/2

Ошибка: не указан параметр reassign

{
	"code": "rest_missing_callback_param",
	"message": "Отсутствует параметр: reassign",
	"data": {
		"status": 400,
		"params": [
			"reassign"
		]
	}
}

Укажем этот параметр:

$ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/users/2?reassign=1

Опять ошибка: нужно обязательно указать force=true

{
	"code": "rest_trash_not_supported",
	"message": "Пользователей нельзя переместить в корзину. Установите 'force=true' для удаления.",
	"data": {
		"status": 501
	}
}

Укажем и этот параметр

$ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/users/2?reassign=1&force=true

Юзер удален:

{
	"deleted": true,
	"previous": {
		"id": 2,
		"username": "neuser",
		"name": "neuser",
		"first_name": "",
		"last_name": "",
		"email": "asd@asd.ru",
		"url": "",
		"description": "",
		"link": "http://wptest.ru/author/neuser/",
		"locale": "ru_RU",
		"nickname": "neuser",
		"slug": "neuser",
		"roles": [
			"subscriber"
		],
		"registered_date": "2018-08-31T13:36:18+00:00",
		"capabilities": {
			"read": true,
			"level_0": true,
			"subscriber": true
		},
		"extra_capabilities": {
			"subscriber": true
		},
		"avatar_urls": {
			"24": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=24&d=mm&r=g",
			"48": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=48&d=mm&r=g",
			"96": "http://0.gravatar.com/avatar/3731f606afa8dccc9123bdd4062c4af1?s=96&d=mm&r=g"
		},
		"meta": []
	}
}
Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться