Быстрый старт
OnPress — платформа сайтов, которой можно управлять через API или поручить это AI-агенту. Для начала зарегистрируйтесь, получите токен и опубликуйте первую страницу. Затем узнаете, как настроить внешний вид, вывести данные и опубликовать приложение.
Зарегистрируйтесь и получите токен
Зарегистрируйтесь на сайте, и сразу после этого вы получите токен. Передайте его AI-агенту, и он поможет вам создать сайт, или создайте сайт сами. Токен дает все права на ваши сайты, поэтому храните его как пароль. Позже его можно найти в консоли: «Настройки» → «API-ключи».
Запрос GET /sites отдает id ваших сайтов в поле site_id, этот же id есть в разделе «Данные» в консоли. Сохраните токен и id в переменные, они нужны во всех примерах:
export OP_TOKEN=op_ВАШ_ТОКЕН
export SITE=ВАШ_SITE_ID
export API=https://onpress.pro/api/v2
Подробнее — в разделе «Авторизация» справочника.
Дайте задачу агенту
В каждом разделе консоли есть кнопка «Промпт для AI». Она копирует задание именно для этого раздела: инструкцию, что и как там делать, адрес API, ваш сайт и токен. Вставьте его в чат агента и допишите, что нужно сделать. Задание можно собрать и самому:
Ты работаешь с сайтом на OnPress через API.
Адрес API: https://onpress.pro/api/v2/site/ВАШ_SITE_ID
Токен: op_ВАШ_ТОКЕН, заголовок Authorization: Bearer
Гайды: https://onpress.pro/docs/v2/ru/guides.md
Справочник: https://onpress.pro/docs/v2/ru/reference.md
Задача: опубликуй страницу «О компании» с этим текстом: …
У каждой страницы документации есть копия в Markdown по тому же адресу с окончанием .md. Подробнее об API — в справочнике.
Опубликуйте первую страницу
POST /pages/markdown создает страницу из Markdown. В начале документа идут свойства страницы: name задает название, url адрес, а frame выбирает ее верстку. Запрос можно отправить из любого языка, скрипта или агента:
curl -s -X POST "$API/site/$SITE/pages/markdown" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"markdown": "---\nname: Первая страница\nurl: /first-page/\nstatus: publish\nframe: article\n---\n\nЭту страницу опубликовал один запрос.\n\n## О сайте\n\nТекст страницы написан в Markdown."}'
Страница уже на сайте по адресу из поля link:
{
"success": true,
"id": 7356,
"url": "/first-page/",
"link": "https://example.onpress.pro/first-page/"
}
Подробнее — на странице «Страницы».
Поменяйте внешний вид фреймом
Фрейм — это HTML-верстка страницы. Поле {{page.title}} выводит название страницы, а атрибут data-op-html выводит ее текст. Загрузите фрейм и поставьте его на страницу:
curl -s -X POST "$API/site/$SITE/frames" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"slug": "start", "html": "<main class=\"start\"><h1>{{page.title}}</h1><div data-op-html=\"page.content\"></div></main>"}'
curl -s -X PATCH "$API/site/$SITE/pages/first-page" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"frame": "start"}'
Подробнее — на страницах «Фреймы» и «Поля данных».
Опубликуйте приложение
Приложение — это фрейм со своим скриптом, который выполняет браузер посетителя. Загрузите разметку, добавьте файл script.js и опубликуйте страницу с этим фреймом:
curl -s -X POST "$API/site/$SITE/frames" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"slug": "counter", "html": "<main class=\"counter\"><button id=\"count\">Нажато: 0</button></main>"}'
curl -s -X PUT "$API/site/$SITE/frames/counter/files?name=script.js" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"content": "let n = 0;\nconst button = document.getElementById(\"count\");\nbutton.onclick = () => { n += 1; button.textContent = \"Нажато: \" + n; };\n"}'
curl -s -X POST "$API/site/$SITE/pages/markdown" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"markdown": "---\nname: Счетчик\nurl: /counter/\nstatus: publish\nframe: counter\n---"}'
Подробнее — на странице «Приложения», готовые примеры — в демо.
Что дальше
- Настройки сайта — название, главная страница и доступ к сайту.
- Свой домен — подключите адрес сайта.
- SEO — заголовки, описания и карта сайта.
- Аналитика — Метрика, Google Analytics и Search Console.
- Меню и стили — навигация и оформление.
- Языки и переводы — версии сайта на других языках.
- Медиа — картинки и файлы.
- Данные — списки, которые выводят страницы.