Ringostat
Zaloguj

Autoryzacja: które API wybrać

~4 min · Dwa transporty — /rpc (klucz API) i /mcp (sesja MCP).

Ringostat udostępnia dwa sposoby wywołania API. Zasada wyboru jest prosta:

  1. 1
    Pojedyncze zapytanie z Twojego backendu → /rpc z nagłówkiem X-API-Key. Bez sesji, jeden POST.
  2. 2
    Agent AI / klient MCP → /mcp z tym samym kluczem w nagłówku Authorization: Bearer (albo przez OAuth): initialize → Mcp-Session-Id → tools/call. Metody wykrywa się przez tools/list.
# /rpc — jedno zapytanie
POST https://apiagent.ringostat.com/rpc
X-API-Key: <TWÓJ_KLUCZ_API>
Content-Type: application/json

{ "jsonrpc":"2.0", "method":"getCampaignStatus",
  "params":{ "projectID":217, "campaignID":799 }, "id":1 }
# /mcp — najpierw uzgodnienie, potem metody
POST https://apiagent.ringostat.com/mcp
Authorization: Bearer <TWÓJ_KLUCZ_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"} } }
# → w odpowiedzi odczytaj nagłówek Mcp-Session-Id
# 2) te same nagłówki + Mcp-Session-Id:
#    { "jsonrpc":"2.0","method":"notifications/initialized" } → 202
# 3) tools/list i tools/call — z Mcp-Session-Id w każdym zapytaniu

Odpowiedź przychodzi jako application/json albo jako text/event-stream (linie data:; weź obiekt z id Twojego zapytania), więc sprawdzaj Content-Type odpowiedzi. Bez Mcp-Session-Id lub z nieznanym serwer odpowiada 404: wykonaj initialize ponownie.

Klucz API utworzysz w panelu: projekt → Ustawienia → Klucze API (tylko administratorzy projektu). Jeden klucz działa w obu transportach: X-API-Key na /rpc; Authorization: Bearer (lub X-API-Key) na /mcp. /rpc nie akceptuje Authorization: Bearer. Klucz otwiera tylko swój projekt. Pełna lista metod jest w sekcji „API”.
Klienci AI z OAuth (Claude, ChatGPT, Cursor i inni) nie potrzebują klucza: dodaj adres serwera https://apiagent.ringostat.com/mcp i zaloguj się do Ringostat, gdy klient o to poprosi. Taki dostęp obejmuje wszystkie projekty użytkownika, który go zatwierdził.