AiSDocs

Base URL

Для пользовательского сценария и интеграций используйте Library API:

https://apirfc.botsaray.com/v1
https://rfc.botsaray.com/v1   (same-origin для SPA)

Библиотека (UI)

Пять экранов первого этапа:

Library API /v1

Скрывает структуру Directus. Frontend вызывает только эти операции.

{"type":"rfc","title":"...","summary":"...","body_md":"..."}

curl -sS -H "Authorization: Bearer rfc_..." \
  https://apirfc.botsaray.com/v1/projects

Авторизация

Токен из Rfc API Tokens (поле token_secret, вид rfc_...).

Authorization: Bearer <token_secret>

Health

Library API. Без авторизации.

curl -sS https://apirfc.botsaray.com/health

Gatekeeper / Directus proxy (legacy).

Коллекции (legacy Directus Items)

Базовый путь: /items/{collection} — только для служебных интеграций, не для UI библиотеки.

Методы

DELETE на nginx дополнительно защищён basic auth.

Query-параметры

Примеры

Список проектов

curl -sS 'https://apirfc.botsaray.com/items/rfc_projects?fields=id,name,slug,status&limit=50' \
  -H "Authorization: Bearer $TOKEN"

Поиск RFC

curl -sS 'https://apirfc.botsaray.com/items/rfc_documents?search=LLM&fields=id,code,title,status,document_url&limit=20' \
  -H "Authorization: Bearer $TOKEN"

RFC по коду

curl -sS 'https://apirfc.botsaray.com/items/rfc_documents?filter[code][_eq]=RFC_30&fields=id,code,title,body_text,document_url' \
  -H "Authorization: Bearer $TOKEN"

Записи проекта

curl -sS 'https://apirfc.botsaray.com/items/rfc_project_entries?filter[project_id][slug][_eq]=taskcapitan&fields=id,title,slug,entry_type,status,public_url&limit=50' \
  -H "Authorization: Bearer $TOKEN"

Создать entry

curl -sS -X POST 'https://apirfc.botsaray.com/items/rfc_project_entries' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "project_id": 1,
    "entry_type": "idea",
    "title": "Новая идея",
    "slug": "idea-new",
    "summary": "Кратко",
    "body_md": "## Суть\n...",
    "status": "draft",
    "revision_no": 1,
    "metadata_json": {}
  }'

Документы проекта и чат

Всё живёт внутри Rfc Project, не как отдельные «сущности меню». Типы документов — поле entry_type в rfc_project_entries:

Уникальный код документа в проекте — slug (уникален в паре project+slug). Публичный URL — public_url (копируй и шарь): https://rfc.botsaray.com/projects/{project-slug}/{slug}

Список документов проекта

curl -sS 'https://apirfc.botsaray.com/items/rfc_project_entries?filter[project_id][slug][_eq]=taskcapitan&fields=id,entry_type,title,slug,status,public_url&sort=-updated_at' \
  -H "Authorization: Bearer $TOKEN"

Чат документа (комментарии)

Чат участников = rfc_project_entry_comments, привязан к конкретному entry через entry_id.

curl -sS 'https://apirfc.botsaray.com/items/rfc_project_entry_comments?filter[entry_id][_eq]=1&fields=id,author_name,comment_md,created_at&sort=created_at' \
  -H "Authorization: Bearer $TOKEN"

curl -sS -X POST 'https://apirfc.botsaray.com/items/rfc_project_entry_comments' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "entry_id": 1,
    "author_name": "Ivan",
    "comment_md": "Согласен с планом, давайте в цикл 2."
  }'

Reader URL (браузер)

Человекочитаемые страницы на UI-домене (basic auth reader):

Ошибки

Тело ошибки Directus:

{
  "errors": [
    {
      "message": "...",
      "extensions": { "code": "INVALID_CREDENTIALS" }
    }
  ]
}

Админка

• https://rfc.botsaray.com/admin/
• Проекты: rfc_projects
• RFC: rfc_documents
• Токены: rfc_api_tokens