Ошибки и частые проблемы

Почти всегда у страницы нет фрейма: на сайте v2 страницу выводит только её фрейм. Проверьте GET /pages/{ref} → page.frame; null — поставьте фрейм (PATCH /pages/{ref} с frame). Другие причины: статус не publish или неопубликован кто-то из родителей (visible: false в ответе публикации); фрейм удалён; адрес другой — возьмите его из link (у языка не по умолчанию есть префикс /en/…).

Проверяйте запросом без кук: вошедший в WordPress видит свежую страницу, а посетитель — копию из кэша. API сбрасывает кэш зависимых страниц сам — и когда блок стоит во фрейме страницы, и когда он вставлен прямо в тело через onpress/frame или onpress/repeat; какие страницы задело, видно в ответе записи: rebaked.pages и rebaked.cache.pages. Если правили мимо API, сбросьте кэш адреса — POST /cache/flush {"urls": ["/адрес/"]}. Если у страницы статическая копия, а правили что-то мимо API, — POST /frames/rebake.

Публикация без id ищет существующую страницу по слагу под тем же родителем. Поменяли url на другого родителя — нашлась «не та» ветка, создана вторая страница. Удалите дубль (DELETE /pages/{id}?force=true) и публикуйте с id во frontmatter. Так же дубль появляется при ошибке в слаге или другом lang.

Слаг берётся из slug, а не из последнего сегмента url: без slug он собирается из заголовка. Пишите slug и url согласованно. Если слаг занят в том же языке под тем же родителем, API добавит суффикс -2 — смотрите slug_changed в ответе.

Смотрите GET /data/menu.<область>?lang=<язык>: meta.menu_id: 0 — в области на этом языке нет меню (PUT /menus/{ref}/location); meta.invalid_items больше нуля — пункты ведут на удалённые или черновые страницы; same_name_dataset — шапка сайта собрана из набора с тем же коротким именем. Если GET /menus показывает меню в области, а на странице пусто, сравните theme в ответе с темой сайта.

Атрибут data-op-bind написан в двойных кавычках (оборвался) — пишите в одинарных. Токен без значения (page.parent_title у страницы верхнего уровня) или с ошибкой в имени — он в bake.response.unresolved ответа записи фрейма. item.* работает только внутри onpress/repeat.

POST /data/resolve с теми же source, match, page, lang покажет, что он получает. Частые причины: контекстный источник (pages.children, breadcrumbs) без страницы; match по полю, которого нет у элементов; значения сравниваются строками ("3" равно 3, но "3 " — нет); вариант набора на языке страницы пуст, а общего набора нет.

422 translation_link_failed с reason: нет lang (lang_required), язык совпадает с оригиналом (same_language), оригинала нет (origin_not_found), у оригинала нет языка (origin_has_no_language — почините POST /pages/language). 409 lang_mismatch — во frontmatter перевода остался id оригинала; выгружайте с ?as=translation_source.

missing_token — заголовок не дошёл (проверьте Authorization: Bearer $OP_TOKEN и что переменная задана). invalid_token — токен перевыпущен или отозван, или скопирован не целиком (нужны op_ и 64 символа). После 20 неудачных попыток в минуту с адреса — 429 too_many_auth_failures: подождите Retry-After.

Вы не администратор этого сайта. На адресе /site/{siteId}/ чужой и несуществующий сайт отвечают одинаково — 404 site_not_found; на старом адресе с X-OnPress-Blog-Id — 403 insufficient_role. Сетевые операции (POST /sites, домен, удаление) требуют суперадмина.

Запрос на старом адресе без blog_id, заголовка и domain идёт на главный сайт — ответ несёт X-OnPress-Blog-Source: default. Пишите через /site/{siteId}/….

Больше 120 запросов в минуту. Ждите Retry-After секунд; в каждом ответе есть X-RateLimit-Remaining. Массовые операции (заливка десятков картинок, страниц) делайте с паузами.

Исполнитель на стороне сайта не ответил. Это не ошибка вашего запроса: для записей, которые уже сохранены (фрейм, данные), сохранённое остаётся — повторите вызов позже. Если повторяется на одном сайте, значит исполнитель там не установлен или сайт не отвечает.

У страницы нет языка. POST /pages/language {"missing": true} проставит язык по умолчанию всем таким страницам.