API-referentie

API-sleutels zijn persoonlijk — elk verzoek met een sleutel handelt als jouw gebruikersaccount, met dezelfde rechten die je in de app hebt.

1. Open Instellingen → Beveiliging → API-sleutels in je FluoTest-dashboard.
2. Voer een naam in die vertelt waar de sleutel wordt gebruikt (bijv. "Zapier-script").
3. Klik op Sleutel genereren en kopieer de fluo_…-waarde direct.
4. Bewaar hem veilig — in een wachtwoordmanager of de secrets-opslag van je tool.

• Eén keer zichtbaar: Alleen een SHA-256-hash van de sleutel wordt opgeslagen — ben je hem kwijt, trek hem dan in en genereer een nieuwe.
• Maximaal 10 sleutels: Maak per tool of script een aparte sleutel, zodat je er één kunt intrekken zonder de rest te breken.
• Altijd intrekbaar: Het intrekken van een sleutel werkt direct vanaf het volgende verzoek.
• Gebruik zichtbaar: Bij elke sleutel zie je wanneer hij voor het laatst is gebruikt, zodat oude sleutels makkelijk op te ruimen zijn.

Stuur de sleutel bij elk verzoek mee in de Authorization-header:

Authorization: Bearer fluo_YOUR_API_KEY

Verbind je een AI-assistent in plaats van code te schrijven? Bekijk de MCP-servergids →

Het endpoint is https://fluotest.com/api/mcp. Stuur POST-verzoeken met "Content-Type: application/json", een Accept-header van "application/json, text/event-stream" en een JSON-RPC 2.0-body. Er is geen initialize-handshake nodig — je kunt tools/list en tools/call direct aanroepen.

Antwoorden komen terug als server-sent-events: het JSON-RPC-resultaat staat op de "data:"-regel en de payload van elke tool is een JSON-string in result.content[0].text:

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

Beschikbare tools opvragen

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":{}}'

Een conceptquiz aanmaken

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 }
            ]
          }
        ]
      }
    }
  }'

Quizresultaten opvragen

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" }
    }
  }'

Authenticatieproblemen gebruiken HTTP-statuscodes; problemen binnen een tool-aanroep komen terug als een normaal JSON-RPC-antwoord met isError gezet en de uitleg in de tekstinhoud.