API Reference

API klíče jsou osobní — každý požadavek s klíčem jedná jako váš uživatelský účet se stejnými oprávněními, jaká máte v aplikaci.

1. Otevřete Nastavení → Zabezpečení → API klíče ve svém FluoTest dashboardu.
2. Zadejte název, podle kterého poznáte, kde se klíč používá (např. „Zapier skript“).
3. Klikněte na Vygenerovat klíč a hodnotu fluo_… si hned zkopírujte.
4. Uložte ji na bezpečné místo — do správce hesel nebo úložiště tajemství vašeho nástroje.

• Zobrazí se jen jednou: Ukládá se pouze SHA-256 hash klíče — pokud ho ztratíte, zrušte ho a vygenerujte nový.
• Až 10 klíčů: Vytvářejte samostatné klíče pro každý nástroj či skript, ať můžete jeden zrušit bez rozbití ostatních.
• Kdykoli zrušitelné: Zrušení klíče platí okamžitě od dalšího požadavku.
• Sledování použití: U každého klíče vidíte, kdy byl naposledy použit, takže staré klíče snadno najdete a uklidíte.

Klíč posílejte s každým požadavkem v hlavičce Authorization:

Authorization: Bearer fluo_YOUR_API_KEY

Připojujete AI asistenta místo psaní kódu? Podívejte se na průvodce MCP serverem →

Endpoint je https://fluotest.com/api/mcp. Posílejte požadavky POST s „Content-Type: application/json“, hlavičkou Accept „application/json, text/event-stream“ a tělem ve formátu JSON-RPC 2.0. Není potřeba žádný initialize handshake — tools/list a tools/call můžete volat přímo.

Odpovědi přicházejí jako server-sent-events: výsledek JSON-RPC je na řádku „data:“ a payload každého nástroje je JSON řetězec v result.content[0].text:

event: message
data: {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\n  \"quiz_id\": \"…\",\n  \"status\": \"draft\", …}"}]}}

Výpis dostupných nástrojů

curl -X POST https://fluotest.com/api/mcp \
  -H "Authorization: Bearer fluo_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Vytvoření konceptu kvízu

curl -X POST https://fluotest.com/api/mcp \
  -H "Authorization: Bearer fluo_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "create_quiz",
      "arguments": {
        "title": "Customer readiness check",
        "questions": [
          { "text": "Do you have a budget?", "type": "yes_no", "points": 2 },
          {
            "text": "Company size?",
            "type": "multiple_choice",
            "options": [
              { "label": "1-10", "score": 1 },
              { "label": "11-50", "score": 2 },
              { "label": "50+", "score": 3 }
            ]
          }
        ]
      }
    }
  }'

Získání výsledků kvízu

curl -X POST https://fluotest.com/api/mcp \
  -H "Authorization: Bearer fluo_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_results",
      "arguments": { "quiz_id": "YOUR_QUIZ_ID" }
    }
  }'

Problémy s ověřením používají HTTP stavové kódy; problémy uvnitř volání nástroje se vracejí jako běžná JSON-RPC odpověď s nastaveným isError a vysvětlením v textovém obsahu.