Обновить шорткод формы

POST

/wp-json/wp2tutor-forms/form/v1/updateShortcode

curl --request POST \
  --url https://example.com/wp-json/wp2tutor-forms/form/v1/updateShortcode \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "id": 42, "token": "a1b2c3d4e5f60718293a4b5c6d7e8f90", "shortcode": "{\"fullPage\":false,\"width\":\"\",\"height\":\"\",\"css\":\"\"}" }'

Сохраняет вложение формы в post meta shortcode. Это не definition и не стили раннера: только JSON-строка шорткода. Обязательны id, token и shortcode (sanitize_text_field). PHP кладёт строку в meta как есть (если пришла строка). Типичное содержимое после создания формы: fullPage, width, height, css. JSON здесь не валидируется (invalid_json на этой ручке нет). token — та же оптимистическая блокировка, что у updateDefinition: пустой/"0" — 400 empty_token; чужой md5 — 400 invalid_token. В ответе новый token (шорткод входит в md5). Нужно право edit_post. Cookie + X-WP-Nonce или Application Password.

Authorizations

• cookie
• applicationPassword

Request Body^required

Media typeapplication/json

object

id

required

ID записи CPT wp2tutor_form. Обязательно. Нет поста — 404 post_not_found; другой type — 400 invalid_post_type.

integer

token

required

Текущий md5-снимок формы. Обязательно. Пустой/"0" — empty_token; несовпадение — invalid_token.

string

shortcode

required

JSON-строка вложения формы. Обязательно, sanitize_text_field. PHP пишет в meta shortcode без json_decode. Типичные ключи после create_new: fullPage (bool), width, height, css (строки). invalid_json здесь нет.

string

Example

{
  "id": 42,
  "token": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "shortcode": "{\"fullPage\":false,\"width\":\"\",\"height\":\"\",\"css\":\"\"}"
}

Responses

200

Шорткод сохранён. Тело — новый token после записи meta.

Media typeapplication/json

object

token

required

Новый токен оптимистической блокировки после успешной записи. PHP: md5(definition_json + runner + json(styles) + json(l10n) + json(hooks) + json(trackers) + json(shortcode)). Клиент подставляет его в следующий update*. Не magic-link и не Application Password.

string

Example

{
  "token": "0f5a3c9e1b7d2468ace0f13579bdf246"
}

400

Invalid_post_type — запись не CPT wp2tutor_form; invalid_id — то же в args id; empty_token — token пустой или "0"; invalid_token — token не совпал с md5 снимка; rest_missing_callback_param — нет id, token или shortcode.

Media typeapplication/json

object

code

Код WP_Error этой ручки (invalid_token, empty_token, invalid_json, invalid_runner, invalid_permissions, post_not_found, …).

string

message

Человекочитаемый текст из PHP (Invalid token: generated "…", expected "…", Token cannot be empty., Invalid JSON. и т.д.).

string

data

Обычно { status: HTTP-код } у WP_Error этих контроллеров.

object

Example^generated

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

401

Не аутентифицирован. WordPress REST: rest_not_logged_in / rest_forbidden. Cookie + X-WP-Nonce или Application Password.

Media typeapplication/json

object

code

Код WP_Error этой ручки (invalid_token, empty_token, invalid_json, invalid_runner, invalid_permissions, post_not_found, …).

string

message

Человекочитаемый текст из PHP (Invalid token: generated "…", expected "…", Token cannot be empty., Invalid JSON. и т.д.).

string

data

Обычно { status: HTTP-код } у WP_Error этих контроллеров.

object

Example^generated

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

403

Invalid_permissions — нет права edit_post на запись формы. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json

object

code

Код WP_Error этой ручки (invalid_token, empty_token, invalid_json, invalid_runner, invalid_permissions, post_not_found, …).

string

message

Человекочитаемый текст из PHP (Invalid token: generated "…", expected "…", Token cannot be empty., Invalid JSON. и т.д.).

string

data

Обычно { status: HTTP-код } у WP_Error этих контроллеров.

object

Example^generated

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

404

Post_not_found — нет записи с таким id; entity_not_found — FormPost не нашёл запись в сервисе.

Media typeapplication/json

object

code

Код WP_Error этой ручки (invalid_token, empty_token, invalid_json, invalid_runner, invalid_permissions, post_not_found, …).

string

message

Человекочитаемый текст из PHP (Invalid token: generated "…", expected "…", Token cannot be empty., Invalid JSON. и т.д.).

string

data

Обычно { status: HTTP-код } у WP_Error этих контроллеров.

object

Example^generated

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