Инвентарь REST → OpenAPI

Фаза 3: канонические YAML — полноценный контракт (requestBody / security / WpError / коды ответов), не только каталог path’ов. URL — {product}/{slug}/v1. Канон YAML — в плагине docs/openapi/*.yaml. Сайт копирует спеки (npm run sync:openapi) и генерирует MDX (npm run gen-api-docs). Сверка: npm run audit:openapi (path-coverage + глубина: тело или x-empty-body, security, ru/en коды). Исключения сканера: vendor, vendor-lib, tests, includes/analogwp-*. License регистрируется из wp2platform/plugin.php через контроллер wordpress-core — в аудит добавлен явно.

Колонка OpenAPI: контракт — операция описана в YAML с входом/выходом/ошибками.

WP_REST_Server::EDITABLE в PHP = POST|PUT|PATCH; в OpenAPI обычно документирован PATCH (этого достаточно для coverage). CREATABLE = POST, READABLE = GET, DELETABLE = DELETE.

---

wp2platform

Спека: docs/openapi/wp2platform-modules.yaml → /docs/api/wp2platform. Auth по умолчанию: cookie / Application Password (DualRest), сеть.

Site Manager — wp2/site-manager/v1

Клиенты: админка Site Manager. blog_id в path.

METHOD	Path	OpenAPI
GET	/wp-json/wp2/site-manager/v1/sites	контракт
POST	…/sites	контракт
GET	…/sites/slug-availability	контракт
POST	…/sites/bulk	контракт
GET	…/sites/{blog_id}	контракт
PATCH (EDITABLE)	…/sites/{blog_id}	контракт
DELETE	…/sites/{blog_id}	контракт
POST	…/sites/{blog_id}/archive	контракт
POST	…/sites/{blog_id}/unarchive	контракт
POST	…/sites/{blog_id}/activate	контракт
POST	…/sites/{blog_id}/deactivate	контракт
GET	…/sites/{blog_id}/users	контракт
POST	…/sites/{blog_id}/users	контракт
DELETE	…/sites/{blog_id}/users/{user_id}	контракт
GET/POST	…/categories	контракт
PATCH/DELETE	…/categories/{id}	контракт
GET/POST	…/statuses	контракт
PATCH/DELETE	…/statuses/{id}	контракт
GET	…/jobs	контракт
GET	…/jobs/{job_id}	контракт
GET	…/jobs/{job_id}/events	контракт

Site Duplicator — wp2/site-duplicator/v1

METHOD	Path	OpenAPI
POST	/wp-json/wp2/site-duplicator/v1/sites/{blog_id}/duplicate	контракт
GET	…/jobs, …/jobs/{job_id}, …/jobs/{job_id}/events	контракт

Post Duplicator — wp2/post-duplicator/v1

METHOD	Path	OpenAPI
POST	/wp-json/wp2/post-duplicator/v1/posts/{post_id}/duplicate	контракт
POST	…/posts/{post_id}/duplicate-batch	контракт

Multi Network — wp2/multi-network/v1

METHOD	Path	OpenAPI
GET/POST	/wp-json/wp2/multi-network/v1/networks	контракт
GET	…/networks/{network_id}	контракт

Media Converter — wp2/media-converter/v1

Клиенты: скиллы media-hls-encode, media-whisper-tracks (formats, attachments, artifacts/pack). Query blog_id на части ручек.

METHOD	Path	OpenAPI
GET	…/media-converter/v1/formats	контракт
GET/PATCH	…/settings	контракт
POST	…/media, …/encode	контракт
GET	…/attachments/{id}	контракт
POST	…/attachments/{id}/encode	контракт
GET	…/queue, …/queue/{key}	контракт
POST	…/queue/control, …/queue/clear	контракт
DELETE	…/queue/{key}	контракт
POST	…/queue/{key}/formats/{format}/cancel	контракт
GET/POST/DELETE	…/attachments/{id}/frame-miniatures	контракт
GET/POST	…/attachments/{id}/thumbnails	контракт
PATCH/DELETE	…/attachments/{id}/thumbnails/poster	контракт
GET	…/attachments/{id}/artifacts	контракт
POST	…/attachments/{id}/artifacts/pack	контракт
PATCH/DELETE	…/attachments/{id}/artifacts/{folder}	контракт

Subtitles & Timecodes — wp2/media-subtitles-timecodes/v1

Клиент: скилл media-whisper-tracks.

METHOD	Path	OpenAPI
GET/POST/PUT	…/media-subtitles-timecodes/v1/attachments/{id}/tracks	контракт
POST	…/tracks/upload	контракт
PATCH/DELETE	…/tracks/{index}	контракт

Enable Media Replace — wp2/enable-media-replace/v1

METHOD	Path	OpenAPI
GET	…/enable-media-replace/v1/attachments/{id}/replace-info	контракт
POST	…/attachments/{id}/replace	контракт

Ошибка: playback_artifacts_present (409), если к вложению привязаны артефакты playback.

Studio Sync — wp2/studio-sync/v1 (уже канон фазы 2)

Клиент: WP2Studio (STUDIO_SYNC_REST_BASE). Auth: public на POST /desktop/connect; дальше Bearer. PHP: src/Modules/StudioSync/. Не переделывать.

METHOD	Path	Auth	OpenAPI
POST	/wp-json/wp2/studio-sync/v1/desktop/connect	public (one-time token)	контракт
GET	…/desktop/status	Bearer	контракт
POST	…/desktop/disconnect	Bearer	контракт
GET	…/sites	Bearer	контракт
GET	…/status	Bearer (legacy)	контракт
GET	…/sync/items	Bearer	контракт
GET	…/sync/posts/{post_id}	Bearer	контракт
PATCH (EDITABLE)	…/sync/posts/{post_id}	Bearer, body base_hash+content	контракт

Local Sync — wp2/local-sync/v1

Клиенты: скилл 09-local-sync, пайплайн page-builder (POST /validate). Capability: manage_network (MS) / edit_pages. Query blog_id.

METHOD	Path	OpenAPI
GET	/wp-json/wp2/local-sync/v1/projects	контракт
POST	…/sync	контракт
POST	…/validate	контракт

Sections Folder — wp2/sections-folder/v1

Клиент: админка Gutenberg sidebar. manage_categories + edit_posts. Create/delete секций — core /wp/v2/{taxonomy}, не этот API.

METHOD	Path	OpenAPI
GET	/wp-json/wp2/sections-folder/v1/sidebar	контракт
PUT	…/reorder	контракт
PUT	…/assign	контракт
PATCH (EDITABLE)	…/sections/{id}	контракт

Passwordless — wp2/passwordless/v1 (public)

Клиент: WP2 App SPA (AuthContext).

METHOD	Path	OpenAPI
POST	/wp-json/wp2/passwordless/v1/request	контракт
POST	…/verify	контракт

Magic Links — wp2/magic-links/v1 (public)

Клиент: WP2 App SPA.

METHOD	Path	OpenAPI
POST	/wp-json/wp2/magic-links/v1/consume	контракт

Elementor Style Presets — wp2/elementor-style-presets/v1

Клиент: админка Elementor. edit_posts.

METHOD	Path	OpenAPI
GET/POST	/wp-json/wp2/elementor-style-presets/v1/presets	контракт
GET	…/presets/{id}	контракт
PATCH (EDITABLE)	…/presets/{id}	контракт

Media Playback — wp2/media-playback/v1

Клиенты: плееры (Vidstack и др.). Query blog_id, lang.

METHOD	Path	OpenAPI
GET	/wp-json/wp2/media-playback/v1/attachments/{id}	контракт

License — wp2/license/v1 (продукт platform)

Регистрация: plugin.php → LicenseRestController('wp2', 'license', $hub). Репо wp2-wordpress-core не документируется отдельно. Auth: manage_network_options / manage_options.

METHOD	Path	OpenAPI
GET	/wp-json/wp2/license/v1/products	контракт
POST	…/{product_id}/activate	контракт
POST	…/{product_id}/deactivate	контракт
GET	…/{product_id}/status	контракт
GET	…/{product_id}/data	контракт

---

wp2lms

Спека: docs/openapi/wp2lms.yaml.

Static Builder — wp2lms/static-builder/v1

Клиенты: скилл 10-static-builder, CLI bin/static-builder/*. Auth: edit_pages / manage_network. Query blog_id.

WP_Error: wp2lms_static_builder_invalid_blog, blog_not_found, busy, not_found, no_pages, cannot_stop, invalid_id, invalid_api_type, invalid_version, invalid_export_mode, pages_required, invalid_page_ids, page_not_found, create_failed, configure_failed, update_failed, delete_failed, page_cache_rebuild.

METHOD	Path	OpenAPI
GET	/wp-json/wp2lms/static-builder/v1/pages	контракт
GET/POST	…/builds	контракт
GET/PATCH/DELETE	…/builds/{id}	контракт
POST	…/builds/{id}/run	контракт
POST	…/builds/{id}/stop	контракт

Turbo — wp2lms/turbo/v1

Клиенты: Turbo frontend (Gutenberg/Twig), Gravity Forms bridge, xAPI session.

METHOD	Path	Auth	OpenAPI
POST	/wp-json/wp2lms/turbo/v1/xapi-actor/session	cookie (email)	контракт
POST	…/gravity-forms/submit	cookie	контракт
POST	…/dsh/expand	cookie	контракт
GET	…/static/{id}	edit_posts	контракт

---

wp2lms-pro

Спека: docs/openapi/wp2lms-pro.yaml.

Embed Packages — wp2lms-pro/embed-packages/v1

Alias wp2platform/module/embed-packages/v1 снят. Auth: manage_network / edit_pages. Query blog_id.

WP_Error: embed_packages_not_found, delete_failed, page_not_found, invalid_blog, unknown_blog.

METHOD	Path	OpenAPI
GET/POST	/wp-json/wp2lms-pro/embed-packages/v1/packages	контракт
GET/PATCH/DELETE	…/packages/{id}	контракт
POST	…/packages/{id}/content	контракт
POST	…/packages/{id}/materialize-pages	контракт
GET/PUT/DELETE	…/pages/{page_id}/package	контракт
POST	…/batch	контракт

---

wp2tutor

Спека: docs/openapi/wp2tutor.yaml. Namespace разделены по модулям. Bot не в этой спеке (см. wp2tutor-bot).

METHOD	Path	Auth	OpenAPI
GET / POST	/wp-json/wp2tutor/ai/v1/chat	GET public; POST X-Ai-Chat-Secret	контракт
POST	/wp-json/wp2tutor/embedding/v1/sync	manage_options	контракт
POST	…/statuses	manage_options	контракт
POST	…/diagnostics	manage_options	контракт
GET/POST	/wp-json/wp2tutor/rag/v1/datatables	admin	контракт
GET	…/chunk/{id_chunk}	admin	контракт

---

wp2tutor-forms

Спека: docs/openapi/wp2tutor-forms.yaml. Свои NS wp2tutor-forms/form/v1 и wp2tutor-forms/i18n/v1 (не общий wp2tutor/v1). Form: cookie (logged-in). i18n: public.

METHOD	Path	OpenAPI
POST	/wp-json/wp2tutor-forms/form/v1/updateDefinition	контракт
POST	…/updateShortcode	контракт
POST	…/updateStyles	контракт
POST	…/updateL10n	контракт
POST	…/updateRunner	контракт
GET	…/getRunnerData	контракт
GET	/wp-json/wp2tutor-forms/i18n/v1/locale	контракт
GET	…/translation	контракт

---

wp2tutor-bot

Спека: docs/openapi/wp2tutor-bot.yaml. Публичные webhooks. При выкладке сменить URL в Telegram/VK.

METHOD	Path	Auth	OpenAPI
POST	/wp-json/wp2tutor-bot/telegram/v1/webhook/{bot_id}	public	контракт
POST	/wp-json/wp2tutor-bot/vk/v1/callback/{channel_id}	public	контракт
POST	/wp-json/wp2tutor-bot/deepchat/v1/chat/{channel_id}	public + X-Wp2tutor-Bot-Secret	контракт
OPTIONS	…/chat/{channel_id}	public CORS	контракт

Клиенты: Telegram/VK, Deep Chat UI; WP2 App проксирует Deep Chat через wp2app/ai-chat/v1/chat (секрет не в бандле).

---

wp2app

Спека: onepix/wp2app/docs/openapi/wp2app.yaml → /docs/api/wp2app. Cookie + wp_rest nonce. Passwordless/magic-links — не здесь (platform).

WP_Error: wp2app_auth_missing, wp2app_passwordless, wp2app_auth_failed, wp2app_reserved, wp2app_ai_chat_config, wp2app_ai_chat_secret.

METHOD	Path	Auth	OpenAPI
GET	/wp-json/wp2app/auth/v1/me	public (user: null если гость)	контракт
POST	…/login	public	контракт
POST	…/logout	logged-in	контракт
GET	…/nonce	public	контракт
POST	…/lost-password	public	контракт
POST	…/reset-password	public	контракт
GET	/wp-json/wp2app/content/v1?path=	logged-in / guests если Private Site off	контракт
GET	…/{id}	то же	контракт
POST	/wp-json/wp2app/ai-chat/v1/chat	logged-in (wp2app/ai_chat/can_chat)	контракт
OPTIONS	…/chat	public	контракт

---

Вне scope (намеренно нет в YAML продуктов)

• AJAX admin-ajax.php, WP-CLI.
• Core /wp/v2/*, AnalogWP REST, Elementor/WPML чужие namespace.
• Библиотека wp2-wordpress-core как отдельный API (License описан у platform).
• Темы / skin-блоки, wp2app-starter, deprecated отдельные плагины.
• WP2 Wrapper — JS API, не WordPress REST.