• Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • 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.

Токен

Токен (API-ключ) — строка op_ и 64 шестнадцатеричных символа. Ключей у пользователя может быть несколько, своих прав у ключа нет: каждый действует от имени владельца на всех сайтах, где тот администратор, поэтому храните его как пароль. Передайте токен заголовком Authorization: Bearer или X-OnPress-Key — оба равноправны. Например, список фреймов сайта:

curl -s "$API/site/$SITE/frames" \
  -H "Authorization: Bearer $OP_TOKEN"
ЗаголовокФорматОписание
AuthorizationBearer op_…основной способ
X-OnPress-Keyop_…то же самое без слова Bearer; читается, только если нет Authorization: Bearer

Сервис запоминает проверенный токен на минуту, новый токен работает сразу. Удаление ключа сбрасывает эту память, удаленный ключ перестает проходить сразу. Время последнего обращения last_used_at API обновляет не чаще раза в минуту.

КодHTTPКогдаЧто делать
missing_token401нет ни Authorization: Bearer, ни X-OnPress-Keyдобавить заголовок с токеном
invalid_token401токен не той формы, неизвестен или отозванвыпустить ключ в консоли или через POST /me/api-keys
too_many_auth_failures429больше 20 неудачных попыток за минуту с одного адресаподождать Retry-After секунд и исправить токен

Управлять API-ключами

В консоли ключи находятся в «Настройки → API-ключи». Новый ключ не отзывает прежние, удалить можно любой. Кнопка «Промпт для AI» сама выпускает отдельный ключ «Для промптов AI» и подставляет его в промпт. Параметры, ответы и ошибки операций описаны в справочнике пользователей.

МетодПутьДействие
GET/me/api-keysПолучить список ключей
POST/me/api-keysВыпустить ключ
DELETE/me/api-keys/{id}Удалить ключ
POST/me/api-keys/aiПолучить ключ для промптов AI

Чтобы сменить ключ у скрипта или агента, выпустите новый, поставьте его и удалите прежний.

Сессия консоли

Консоль https://onpress.pro/dashboard/ ходит в тот же API не токеном, а сессионной кукой после входа почтой, через Google или Telegram. Эндпоинты принимают и куку, и токен; если в запросе есть и то и другое, а кука истекла, API проверяет токен. Запрос с кукой API принимает только с адреса консоли, иначе отвечает 403 cross_origin. Агенту и скрипту кука не нужна, вход и продление сессии описаны на странице «Состояние API».

Права

Роль одна — администратор сайта: ему открыты все эндпоинты сайта, и чтение, и запись страниц, фреймов, данных, меню, стилей, настроек, языков, SEO, медиа и пользователей сайта. Участник сайта без прав администратора получает 403 insufficient_role на любом эндпоинте сайта, включая чтение, а чужой сайт отвечает 404 site_not_found. Главный сайт сети onpress.pro подчиняется тому же правилу: записывает в него только его администратор. Эндпоинты сети — /me, /sites, /auth, /health, /frames/system — живут без префикса сайта: свой профиль, кредиты, тарифы и библиотека системных фреймов доступны любому владельцу токена, а /sites/{id} отвечает только администратору этого сайта. Например, свой профиль:

curl -s "$API/me" \
  -H "Authorization: Bearer $OP_TOKEN"

Выбор сайта

Сайт называется в пути: $API/site/{siteId}/…. siteId — девять знаков из цифр 2–9 и латиницы без похожих букв l, o, I, O, например x9HTLHECq; он выдается при создании сайта и больше не меняется, поэтому его можно хранить в скриптах и закладках. Идентификатор случайный: по одному id нельзя вычислить соседний. Под этим префиксом живут все эндпоинты сайта: /pages, /data, /frames, /data/menus, /media, /users, /data/docs.sidebar, /data/seo, /redirects и остальные из справочника; настройки, главную страницу и языки сайта отдают системные данные /data/site.settings, /data/site.front_page и /data/site.languages. Например, список системных данных сайта:

curl -s "$API/site/$SITE/data/system" \
  -H "Authorization: Bearer $OP_TOKEN"

Ответ на таком адресе называет сайт заголовком X-OnPress-Site-Id, многие эндпоинты — еще и полем site_id; внутренний номер сайта в нем не появляется. Несуществующий и чужой сайт отвечают одинаково — 404 site_not_found с одним и тем же текстом, поэтому id сайтов нельзя перебрать.

ПараметрГдеТипОписание
siteIdпуть /site/{siteId}/…строкаid сайта из девяти знаков

siteId приходит в ответе POST /sites при создании сайта и полем site_id в GET /sites, GET /sites/{id} и GET /data; в консоли он виден в разделе «Данные», в адресе эндпоинтов сайта. /sites/{id} принимает в пути siteId или домен сайта.

КодHTTPКогдаЧто делать
site_not_found404сайта с таким siteId нет или вы не его администраторпроверить siteId в GET /data или в консоли
insufficient_role403вы участник сайта, но не администраторпопросить администратора сайта выдать права
cross_origin403запрос с кукой сессии пришел не с адреса консолиотправить запрос с токеном

Лимиты

Каждый ответ эндпоинта с авторизацией несет заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset — unix-время, когда освободится самый старый запрос окна. Лимит токена считается на пользователя, а не на токен, и перевыпуск его не обнуляет; у каждой сессии консоли свое окно, отдельное от токена, поэтому скрипт, выбравший лимит токена, не мешает тому же пользователю работать в консоли. Счетчик живет в памяти процесса API, и перезапуск сервиса его обнуляет. Например, посмотреть остаток лимита:

curl -s -D - -o /dev/null "$API/site/$SITE/data/menus" \
  -H "Authorization: Bearer $OP_TOKEN"
x-onpress-site-id: x9HTLHECq
x-onpress-realm: prod
x-ratelimit-limit: 120
x-ratelimit-remaining: 102
x-ratelimit-reset: 1793135732
ЧтоПределОтвет при превышении
Запросы по токену120 в минуту на пользователя, скользящее окно429 too_many_requests и Retry-After
Запросы из консоли120 в минуту на сессию429 too_many_requests и Retry-After
Неудачные попытки с токеном20 в минуту с одного адреса429 too_many_auth_failures и Retry-After
Попытки входа в консоль30 в минуту с одного адреса429 too_many_requests и Retry-After
Тело запроса в JSON10 МБ413 body_too_large
Разметка одного фрейма2 МБ413 frame_too_large
Одни пользовательские данные512 КБ413 dataset_too_large
Собственный CSS сайта256 КБ413 css_too_large
Файл медиа32 МБ в multipart/form-data; base64 в JSON — в пределах 10 МБ тела413 file_too_large
Список страницдо 200 на страницу выдачибольше не отдается
Список медиадо 100 на страницу выдачибольше не отдается

Как повторять запрос после 429 — в разделе «Ошибки».

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