Создать категорию сайтов

POST

/wp-json/wp2/site-manager/v1/categories

curl --request POST \
  --url https://example.com/wp-json/wp2/site-manager/v1/categories \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "name": "Учебные проекты", "slug": "training", "parent_id": 0 }'

Создаёт термин таксономии категорий (wp_insert_term на главном сайте). Обязателен непустой name после trim, иначе 400 missing_name. Нужно manage_network.

Authorizations

• cookie
• applicationPassword

Request Body^required

Media typeapplication/json

object

name

required

Отображаемое имя категории. Обязательно; пустое после trim — 400 missing_name.

string

slug

Ярлык термина. Необязательно; PHP делает sanitize_title. Если не передать — ядро сгенерирует из name.

string

parent_id

Term_id родителя. Необязательно, по умолчанию 0 (корень).

integer

Example

{
  "name": "Учебные проекты",
  "slug": "training",
  "parent_id": 0
}

Responses

201

Категория создана.

Media typeapplication/json

object

id

Term_id категории сайтов (таксономия Site Manager, не рубрика записей).

integer

name

Отображаемое имя термина. В списке PHP может подменить дефолтные ярлыки через translate_default_term_label.

string

slug

Ярлык термина категории (sanitize_title при записи).

string

parent

Term_id родителя (WP_Term->parent); 0 — корень. В SiteDto.categories PHP это поле не кладёт.

integer

Example

{
  "id": 3,
  "name": "Учебные проекты",
  "slug": "training",
  "parent": 0
}

400

Missing_name — пустое имя; прочие WP_Error wp_insert_term (кроме term_exists).

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

401

Не аутентифицирован. DualRest: rest_forbidden (status 401), если нет cookie-сессии. 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

Нет права manage_network или невалидный REST nonce.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

409

Term_exists — термин с таким именем/ярлыком уже есть.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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