Авторизація: який API обрати
~4 хв · Два транспорти — /rpc (API-ключ) та /mcp (MCP-сесія).
Ringostat має два способи виклику API. Правило вибору просте:
- 1Разовий запит зі свого бекенду → /rpc з заголовком X-API-Key. Без сесії, один POST.
- 2AI-агент / 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, коли клієнт попросить. Такий доступ охоплює всі проекти користувача, який його дозволив.