Ringostat
Вхід

Авторизація: який API обрати

~4 хв · Два транспорти — /rpc (API-ключ) та /mcp (MCP-сесія).

Ringostat має два способи виклику API. Правило вибору просте:

  1. 1
    Разовий запит зі свого бекенду → /rpc з заголовком X-API-Key. Без сесії, один POST.
  2. 2
    AI-агент / MCP-клієнт → /mcp з тим самим ключем у заголовку Authorization: Bearer (або через OAuth): initialize → Mcp-Session-Id → tools/call. Методи виявляються через tools/list.
# /rpc — один запит
POST https://apiagent.ringostat.com/rpc
X-API-Key: <ВАШ_API_КЛЮЧ>
Content-Type: application/json

{ "jsonrpc":"2.0", "method":"getCampaignStatus",
  "params":{ "projectID":217, "campaignID":799 }, "id":1 }
# /mcp — рукостискання, далі методи
POST https://apiagent.ringostat.com/mcp
Authorization: Bearer <ВАШ_API_КЛЮЧ>
Content-Type: application/json
Accept: application/json, text/event-stream

{ "jsonrpc":"2.0","id":1,"method":"initialize",
  "params":{ "protocolVersion":"2025-06-18","capabilities":{},
    "clientInfo":{"name":"my-app","version":"1.0.0"} } }
# → у відповіді читайте заголовок Mcp-Session-Id
# 2) ті самі заголовки + Mcp-Session-Id:
#    { "jsonrpc":"2.0","method":"notifications/initialized" } → 202
# 3) tools/list і tools/call — з Mcp-Session-Id у кожному запиті

Відповідь приходить як application/json або як text/event-stream (рядки data:; беріть об'єкт з id вашого запиту), тож дивіться на Content-Type відповіді. Без Mcp-Session-Id або з невідомим сервер відповідає 404: виконайте initialize ще раз.

API-ключ створюється в кабінеті: проект → Налаштування → Ключі API (лише адміністратори проекту). Один ключ працює в обох транспортах: X-API-Key на /rpc; Authorization: Bearer (або X-API-Key) на /mcp. /rpc не приймає Authorization: Bearer. Ключ відкриває лише свій проект. Повний перелік методів — у розділі «API».
AI-клієнтам з OAuth (Claude, ChatGPT, Cursor та інші) ключ не потрібен: додайте адресу сервера https://apiagent.ringostat.com/mcp і увійдіть у Ringostat, коли клієнт попросить. Такий доступ охоплює всі проекти користувача, який його дозволив.