Публичная документация
Articles Bot API
Base URL: https://routerapi.ru/api/bot/v1
OpenAPI: /docs/openapi/articles-bot-api.yaml и GET /api/bot/v1/openapi.json (с Bearer).
Авторизация:
MCP_BOT_API_TOKEN— полный доступ.MCP_BOT_API_TOKEN_RO— толькоGET/HEAD.
Минимальная длина опубликованной статьи: ARTICLES_MIN_BODY_CHARS (по умолчанию 2000). Ревизии: REVISIONS_KEEP_DAYS, REVISIONS_KEEP_MIN.
Поля записи
Каноническое тело статьи — content (Editor.js). Поле body без content даёт 422 use_content_field.
Поддерживаются: title, slug, excerpt, content, tag_ids, category_ids, meta_title, meta_description, og_*, dry_run, expected_revision, заголовок Idempotency-Key, If-Match.
dry_run: true ничего не пишет в БД. В ответе: meta.dry_run, meta.would_status, meta.checks.
Проверки публикации (banned_terms, длина) запускаются при publish и при изменении content / title / excerpt. PATCH только tag_ids у опубликованной статьи их не гоняет.
Каждое изменение (включая смену тегов, publish, unpublish, restore) увеличивает revision и ETag.
Основные действия
GET /health— без токена.GET /openapi.json— схема.GET /articles— список; фильтрыtag(slug) иtag_idдают один результат. Вmeta:page,per_page,total,total_pages.POST /articles— всегда черновик.PATCH /articles/{id}— поля + ревизии.POST /articles/{id}/publish/unpublish— смена статуса.POST /articles/{id}/preview— signed URL на 24 часа,noindex,follow.GET /tags— список сarticles_count(опубликованные непустые) и meta пагинации.
Ошибки
401 unauthorized403 read_only_token409 revision_conflict/live_content/idempotency_conflict422 publish_blocked— детали вfailed_checks422 use_content_field— присланbodyбезcontent422 invalid_tag_name— недопустимое имя тега
Если на сервере задан MCP_BANNED_TERMS, он полностью заменяет список по умолчанию. Токены telegram-бот / телеграм-бот из дефолта убраны; при кастомном env их нужно убрать вручную на стейдже.
Нужен следующий раздел?
Откройте обзор, dashboard, мультимодальность или технические сценарии API.