• Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
OnPress OnPress
Документация Справочник API Контакты
Войти Начать
Документация Справочник API Контакты Войти
    • Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
Справочник API Управление
Markdown
Открыть в ИИ
  • Открыть в ChatGPT
  • Открыть в Claude
  • Открыть в Gemini
  • Открыть в Perplexity
  • Открыть в Grok
  • Открыть в DeepSeek

Ошибки

Здесь формы ответа и общие коды ошибок API. Как исправлять частые проблемы — в гайде; специальные коды описывает каждый эндпоинт справочника.

info

Во всех примерах API — https://onpress.pro/api/v2, SITE — id сайта (SITE_ID), OP_TOKEN — токен op_XXXX. Полный перечень эндпоинтов — в справочнике API.

Успешный ответ

Успешный ответ — объект с "success": true и полями эндпоинта; на адресе /site/{siteId}/… ответ называет сайт заголовком X-OnPress-Site-Id, а многие эндпоинты — еще и полем site_id. Поле warnings перечисляет предупреждения на английском. Предупреждение не отменяет успешную запись. Например, публикация черновика проходит, а ответ напоминает, что по адресу адрес пока не отдает страницу. Свои ключи из свойств страницы ответ публикации перечисляет не в warnings, а в отдельном поле data_keys.

curl -s -X POST "$API/site/$SITE/pages/markdown" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"markdown": "---\nname: Проба\nstatus: draft\n---\n\nТекст."}'
{
  "success": true,
  "site_id": "x9HTLHECq",
  "updated": false,
  "id": 6446,
  "…": "…",
  "warnings": ["page is not published (status \"draft\"), the address does not serve it"]
}
ПолеТипОписание
successbooleantrue
site_idстрокаid сайта, если эндпоинт называет сайт в ответе
warningsмассив строкпредупреждения: проигнорированное поле, почищенный якорь, неопубликованная страница; есть не всегда

Отказ эндпоинта

Если запрос дошел до эндпоинта и тот отказал, ответ — объект с "success": false, машинным кодом в error, пояснением в message и полями конкретного отказа рядом. Например, запрос несуществующего поля настроек:

curl -s "$API/site/$SITE/data/settings/description" \
  -H "Authorization: Bearer $OP_TOKEN"
{
  "success": false,
  "error": "unknown_settings_field",
  "message": "there is no settings field \"description\"; the fields are: name, icon, closed, front_page, languages, metrika, ga, gsc, webmaster",
  "fields": ["name", "icon", "closed", "front_page", "languages", "metrika", "ga", "gsc", "webmaster"]
}
ПолеТипОписание
successbooleanfalse
errorстрокамашинный код отказа
messageстрокапояснение на английском, текст может уточняться
другие полялюбойподробности отказа: допустимые значения, имя поля, версия страницы

Отказ до эндпоинта

Отказы при проверке токена, выбора сайта и лимита, неразборчивое тело и несуществующий маршрут приходят в другой форме: код в поле code, статус — в data.status. Например, запрос к несуществующему сайту:

curl -s "$API/site/AAAAAAAAA/data/menus" \
  -H "Authorization: Bearer $OP_TOKEN"
{ "code": "site_not_found", "message": "there is no site AAAAAAAAA you can reach with these credentials", "data": { "status": 404 } }

Ветвитесь по error или code и HTTP-статусу, а не по тексту message.

Общие коды

Общая авторизация и обработка запросов возвращают эти коды. Специальные коды и действия описывает профильная операция справочника.

КодHTTPКогдаЧто делать
operation_failed502Профильная операция системных данных сообщила о неудаче без собственного кода; детали в result.Проверьте result и повторите действие после устранения причины.
source_read_not_supported405GET у имени, предназначенного только для записи.Используйте методы из write.methods в каталоге системных данных.
source_auth_required403Для профильной операции не определен авторизованный администратор сайта.Проверьте токен и доступ к выбранному сайту.
wrong_method_for_source405Метод не поддерживается этим именем системных данных.Используйте метод из справочника сущности или каталога.
missing_token401нет заголовка с токеномдобавить Authorization: Bearer $OP_TOKEN
invalid_token401токен не той формы, неизвестен или отозванвзять действующий токен
too_many_auth_failures429больше 20 неудачных попыток с токеном за минуту с одного адресаподождать Retry-After секунд, исправить токен
cross_origin403запрос с кукой сессии пришел не с адреса консолиотправить запрос с токеном
site_not_found404сайта нет или вы не его администраторпроверить siteId
insufficient_role403вы участник сайта, но не администраторполучить права администратора
too_many_requests429больше 120 запросов в минутуподождать Retry-After секунд и повторить
invalid_json400API не может разобрать тело как JSONпроверить тело и Content-Type: application/json
body_too_large413тело больше 10 МБразбить запрос на части
not_found404нет такого маршрутапроверить метод и путь по справочнику
method_not_allowed405GET на эндпоинт входа, который работает только с POSTотправить POST
dry_run_not_supported400dry_run у эндпоинта, у которого нет пробного прогонаубрать dry_run; ничего не записано
gone410эндпоинт снятперейти на адрес из message
wrong_realm409запись пришла не на рабочий адрес API; ничего не записаноотправить тот же запрос на https://onpress.pro/api/v2
internal_error, auth_error500сбой сервисаповторить позже; не проходит — написать в поддержку
db_error500база отказала в записи, код драйвера в db_codeповторить позже; не проходит — написать в поддержку
internal_unavailable502исполнитель на стороне сайта не ответилповторить позже

Повтор после 429

Ответ 429 несет заголовок Retry-After — через сколько секунд освободится место в окне. Подождите столько секунд и повторите тот же запрос; API не исполнил операцию с отказом 429. Например, чтобы увидеть заголовок:

curl -s -D - -o /dev/null "$API/site/$SITE/pages" \
  -H "Authorization: Bearer $OP_TOKEN"
HTTP/2 429
retry-after: 15
x-ratelimit-limit: 120
x-ratelimit-remaining: 0
x-ratelimit-reset: 1793135747

Лимиты и заголовки X-RateLimit-* — в разделе «Авторизация».

arrow_backНазад
Почта на домене
Далееarrow_forward
Стили и оформление
На этой странице
  • Успешный ответ
    • Отказ эндпоинта
      • Отказ до эндпоинта
        • Общие коды
          • Повтор после 429
          1. Главная
          2. Docs
          3. Документация OnPress v2
          4. Справочник API
          5. Ошибки
          © 2026 OnPress ИП Зуев И.В. ИНН: 360408359441 info@onpress.pro Политика конфиденциальности Публичная оферта
          • Visa
          • Mastercard
          • Сбер Pay
          • T-Pay