Справочник: языки
Ручки сайта: $API/site/$SITE/languages…. Сайт без Polylang отвечает 409 polylang_inactive на любую. Все ручки, кроме GET /languages/{lang}, отвечают полным состоянием — default, settings, languages — и записи несут cache (что сброшено). Подробно — языки сайта.
Поля языка: slug, locale, name, rtl, order, flag, flag_url, is_default, term_id, w3c, url, front_page ({id, url} или null), counts ({posts, terms}).
GET /languages
curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/languages"{
"success": true,
"site_id": "x9HTLHECq",
"default": "en",
"settings": { "force_lang": 1, "hide_default": true, "redirect_lang": true, "rewrite": true, "browser": false, "media_support": true },
"languages": [
{ "slug": "en", "locale": "en_US", "name": "English", "rtl": false, "order": 0, "flag": "us", "flag_url": "https://test.onpress.pro/wp-content/plugins/polylang-pro/vendor/wpsyntex/polylang/flags/us.png", "is_default": true, "term_id": 88, "w3c": "en-US", "url": "https://test.onpress.pro/", "front_page": { "id": 5776, "url": "https://test.onpress.pro/" }, "counts": { "posts": 41, "terms": 8 } },
{ "slug": "ru", "locale": "ru_RU", "name": "Русский", "rtl": false, "order": 0, "flag": "ru", "is_default": false, "term_id": 91, "w3c": "ru-RU", "url": "https://test.onpress.pro/ru/", "front_page": { "id": 6037, "url": "https://test.onpress.pro/ru/" }, "counts": { "posts": 37, "terms": 1 } }
]
}GET /languages/{lang}
{ "success": true, "site_id": "x9HTLHECq", "language": { "slug": "ru", "locale": "ru_RU", "name": "Русский", "…": "…" } }Отказы: 404 language_not_found, 400 invalid_language.
POST /languages
| Поле | Смысл |
|---|---|
locale | обязательно: en_US, ru_RU, ar, zh_CN |
slug, name, rtl, flag, order | переопределить значения Polylang |
default_category | создать рубрику для языка (по умолчанию нет) |
curl -s -X POST "$API/site/$SITE/languages" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' -d '{"locale": "de_DE"}'{ "success": true, "site_id": "x9HTLHECq", "changed": true, "language": { "slug": "de", "name": "Deutsch", "url": "https://test.onpress.pro/de/", "front_page": null, "…": "…" }, "default": "en", "settings": { "…": "…" }, "languages": [ "…" ], "cache": { "…": "…" } }201 — создан, 200 с changed: false — уже был ровно таким. Отказы: 400 locale_required, 400 invalid_locale, 400 locale_unknown, 400 invalid_language, 400 invalid_name, 400 invalid_flag, 400 invalid_order, 400 unknown_field, 409 language_exists (diff), Polylang: 400 pll_* (details).
PATCH /languages/{lang}
Поля slug, locale, name, rtl, flag, order. Ответ: changed, diff (при изменении), полное состояние. Смена слага меняет адреса всех страниц языка. Отказы: 400 nothing_to_change, 404 language_not_found, проверки полей как у POST, 400 pll_invalid_slug, 400 pll_non_unique_slug, 400 pll_invalid_locale, 400 pll_invalid_flag, 400 pll_invalid_name.
DELETE /languages/{lang}
| Параметр (строка запроса или тело) | Смысл |
|---|---|
force | удалить, даже если у языка есть содержимое |
curl -s -X DELETE "$API/site/$SITE/languages/de" -H "Authorization: Bearer $OP_TOKEN"{ "success": true, "site_id": "x9HTLHECq", "changed": true, "deleted": true, "usage": { "posts": 0, "pages": 0, "terms": 0 }, "language": { "slug": "de", "…": "…" }, "default": "en", "settings": { "…": "…" }, "languages": [ "…" ], "cache": { "…": "…" } }Отказы: 409 language_in_use (usage; снимается force), 409 language_is_default, 409 last_language, 404 language_not_found, 500 language_delete_failed.
PUT /languages/default
| Поле | Смысл |
|---|---|
lang | новый язык по умолчанию (синонимы language, slug) |
Ответ: changed, was (прежний, при изменении), language, полное состояние. Отказы: 404 language_not_found.
PATCH /languages
Настройки адресов языков: force_lang (1 — каталог, 2 — поддомен, 3 — домен), hide_default, redirect_lang, rewrite, browser, media_support. Применяются начиная с force_lang. Ответ: changed — список записанных ключей, before, settings — перечитанные после записи, полное состояние.
curl -s -X PATCH "$API/site/$SITE/languages" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' -d '{"hide_default": true, "redirect_lang": true}'Отказы: 400 nothing_to_change, 400 unknown_field, 400 invalid_force_lang.