RouterAPI Docs

Articles Bot API

Документация RouterAPI помогает быстро понять, как работать с публичным API, кабинетом, RouterAPI Gateway и мультимодальными сценариями.

Публичная документация

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 unauthorized
  • 403 read_only_token
  • 409 revision_conflict / live_content / idempotency_conflict
  • 422 publish_blocked — детали в failed_checks
  • 422 use_content_field — прислан body без content
  • 422 invalid_tag_name — недопустимое имя тега

Если на сервере задан MCP_BANNED_TERMS, он полностью заменяет список по умолчанию. Токены telegram-бот / телеграм-бот из дефолта убраны; при кастомном env их нужно убрать вручную на стейдже.

Нужен следующий раздел?

Откройте обзор, dashboard, мультимодальность или технические сценарии API.