Чим ми можемо допомогти?

Стисло опишіть питання; ми відповімо електронною поштою.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
На головну

Серверний API (REST v1) і MCP

REST-інтерфейс reactive.chat для бекенду: ключі й права API, обмеження частоти, формати відповідей і помилок, розбиття на сторінки, кінцеві точки проєктів, розмов, повідомлень, відвідувачів, подій, правил і hooks та сервер MCP для ШІ.

Серверний API призначений для вашого бекенду, а не для браузера: він не дозволяє CORS, а ключ API ніколи не має бути на вебсторінці чи в застосунку.

Основи

Ключі API

В обліковому записі в розділі Ключі API (/app/api-keys, лише власники й адміністратори). Ви задаєте назву й права; ключ (rc_live_ + 48 символів) показується рівно один раз, а ми зберігаємо лише хеш.

Права:

Ключ належить рівно одному робочому простору; жоден шлях чи параметр не вибирає іншого. Він стає недійсним після відкликання або коли його автор більше не є власником чи адміністратором робочого простору. Строку дії немає — виконуйте ротацію самостійно (створіть новий, перейдіть на нього, відкличте старий).

Надсилання:

curl https://reactive.chat/v1/me -H "Authorization: Bearer rc_live_..."

Заголовок X-Api-Key: rc_live_... рівнозначний (читається лише за відсутності Authorization: Bearer).

Обмеження частоти

Формат відповіді

{ "data": { ... } }

Списки:

{ "data": [ ... ], "has_more": true, "next": { "before_id": "812" } }

Розбиття на сторінки: limit (стандартно 25, щонайбільше 100) і курсор — before_id для списків «спочатку нові», after_id для списків «спочатку старі». next є лише коли has_more дорівнює true. Загальної кількості немає.

Тіла POST/PUT: лише Content-Type: application/json (інакше 415), щонайбільше 65 536 байтів (інакше 413), об’єкт JSON із щонайбільше 32 рівнями.

Формат помилки

{ "error": { "code": "insufficient_scope", "message": "...", "required_scope": "write" } }

message — фіксоване англійське речення для розробників. Залежно від помилки додаються param, required_scope, max, allowed, reason. Повний перелік кодів:

Кінцеві точки

Обліковий запис

Проєкти (read)

Розмови (read)

Повідомлення

curl -X POST https://reactive.chat/v1/conversations/815/messages \
  -H "Authorization: Bearer rc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"body":"Your return has arrived.","author_type":"agent","client_ulid":"01JAB3C4D5E6F7G8H9JKMNPQRS"}'

Відвідувачі (read)

Події

{ "project_id": "123", "type": "bestellung.storniert",
  "session_id": "s_...", "conversation_id": "01JAB...",
  "payload": { "nummer": "2026-0815" }, "ts": 1792503600000 }

type відповідає ^[a-z][a-z0-9_.:-]{0,47}$, payload щонайбільше 8192 байти, ts у мілісекундах (щонайбільше 7 днів тому або 5 хвилин наперед). source завжди integration. Відповідь 201.

Правила (read)

Hooks — див. Вебхуки: GET /v1/hooks, POST /v1/hooks, DELETE /v1/hooks/{id}.

Дані клієнтів — див. Дані клієнтів: PUT та DELETE /v1/kundendaten/{user_id}.

Приклад: збирання відкритих розмов

<?php
$key = getenv('RC_API_KEY');
$url = 'https://reactive.chat/v1/conversations?status=waiting&limit=100';
do {
    $ch = curl_init($url);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key]]);
    $antwort = json_decode((string) curl_exec($ch), true);
    $status  = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    if ($status === 429) { sleep(60); continue; }
    foreach ($antwort['data'] as $g) { echo $g['id'], ' ', $g['created_at'], "\n"; }
    $url = !empty($antwort['has_more'])
        ? 'https://reactive.chat/v1/conversations?status=waiting&limit=100&before_id=' . $antwort['next']['before_id']
        : null;
} while ($url);

Сервер MCP

Для інструментів ШІ з підтримкою Model Context Protocol за тією самою базовою адресою є сервер MCP:

Інструменти (tools/list показує лише дозволені вашому ключу):

Без besucherdaten:lesen ім’я, електронна пошта й телефон відвідувачів скорочуються, а персональні дані в текстах маскуються. Помилки інструментів надходять як isError: true з ідентифікаторами на кшталт project_not_found, conversation_not_found, conversation_closed, disabled, bad_argument, too_long, search_rate_limited.

Зразок запису для клієнта MCP:

{
  "mcpServers": {
    "reactive-chat": {
      "url": "https://reactive.chat/v1/mcp",
      "headers": { "Authorization": "Bearer rc_live_..." }
    }
  }
}

MCP і список відвідувачів — нові функції; їх можна вимкнути для окремого проєкту (тоді відповідний проєкт повідомляє disabled).

Чого немає

Далі: Вебхуки · Інтеграції та канали

Оновлено: