Проверить доступность слага сайта

GET

/wp-json/wp2/site-manager/v1/sites/slug-availability

curl --request GET \
  --url 'https://example.com/wp-json/wp2/site-manager/v1/sites/slug-availability?slug=example' \
  --header 'X-WP-Nonce: <X-WP-Nonce>'

Нормализует предлагаемый адрес сайта и проверяет, свободна ли пара domain+path в текущей сети (domain_exists). Query slug обязателен. exclude_blog_id — не считать конфликтом этот blog_id (проверка перед переименованием: если адрес уже у этого сайта, available=true). Нужно create_sites или manage_network. Только multisite.

Authorizations

• cookie
• applicationPassword

Parameters

Query Parameters

slug

required

string

Предлагаемый адрес: поддомен (SUBDOMAIN_INSTALL) или сегмент пути. PHP прогоняет SlugNormalizer и собирает domain+path текущей сети без auto_increment.

exclude_blog_id

integer

Blog_id сайта, который не считать занятым. Если domain_exists вернул именно этот id — available=true. 0 / не число — как будто параметра нет. Нужен при смене слага существующего сайта.

Responses

200

Нормализованный слаг и флаг available. Пустой slug после нормализации → available=false, slug=“”.

Media typeapplication/json

object

available

True, если пара domain+path свободна в текущей сети (domain_exists) либо уже принадлежит exclude_blog_id. false, если слаг пустой после нормализации, сеть не резолвится или адрес занят другим сайтом.

boolean

slug

Нормализованный ярлык после SlugNormalizer и prepare_domain_and_path без auto_increment. Пустая строка, если на вход дали пустой slug.

string

Example

{
  "available": true,
  "slug": "training"
}

400

Not_multisite — это не сеть WordPress.

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

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

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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