Référence de l'API FluoTest

L'API publique de FluoTest est servie par son endpoint MCP, une API JSON-RPC 2.0 en HTTPS classique qui fonctionne avec curl ou n'importe quel client HTTP, sans bibliothèque MCP. Vous vous authentifiez avec une clé API personnelle.

Dernière mise à jour

Comment appeler l'API FluoTest ?

Générez une clé API dans Paramètres → Sécurité → Clés API, puis envoyez des requêtes JSON-RPC en POST vers https://fluotest.com/api/mcp avec la clé dans un en-tête « Authorization: Bearer ». Onze outils sont disponibles aujourd'hui : list_quizzes, create_quiz, import_quiz, get_quiz_questions, get_quiz_settings, update_quiz, publish_quiz, unpublish_quiz, duplicate_quiz, get_results et delete_quiz.

Obtenir une clé API#

Les clés API sont personnelles : chaque requête faite avec une clé agit en tant que votre compte utilisateur, avec les mêmes autorisations que dans l'application.

  1. Ouvrez Paramètres → Sécurité → Clés API dans votre tableau de bord FluoTest.
  2. Saisissez un nom qui indique où la clé sera utilisée (par ex. « Script Zapier »).
  3. Cliquez sur Générer une clé et copiez immédiatement la valeur fluo_….
  4. Conservez-la en lieu sûr : un gestionnaire de mots de passe, ou le stockage des secrets de votre outil.
  • Affichée une seule fois: Seul un hachage SHA-256 de la clé est conservé. Si vous la perdez, révoquez-la et générez-en une nouvelle.
  • Jusqu'à 10 clés: Créez des clés distinctes par outil ou script pour pouvoir en révoquer une sans casser les autres.
  • Révocable à tout moment: La révocation d'une clé prend effet immédiatement dès la requête suivante.
  • Suivi d'utilisation: Chaque clé indique quand elle a été utilisée pour la dernière fois, pour repérer et supprimer facilement les clés inutilisées.

Authentification#

Envoyez la clé avec chaque requête dans l'en-tête Authorization :

Authorization: Bearer fluo_YOUR_API_KEY

Vous connectez un assistant IA plutôt que d'écrire du code ? Voir le guide du serveur MCP →

Format des requêtes#

L'endpoint est https://fluotest.com/api/mcp. Envoyez des requêtes POST avec « Content-Type: application/json », un en-tête Accept « application/json, text/event-stream » et un corps JSON-RPC 2.0. Aucune poignée de main initialize n'est nécessaire : vous pouvez appeler tools/list et tools/call directement.

Les réponses arrivent sous forme de corps server-sent events : le résultat JSON-RPC se trouve sur la ligne « data: », et le payload de chaque outil est une chaîne JSON dans result.content[0].text :

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

Exemples#

Lister les outils disponibles

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

Lister vos quiz

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": 3,
    "method": "tools/call",
    "params": { "name": "list_quizzes", "arguments": {} }
  }'

Créer un quiz en brouillon

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

Obtenir les questions d'un quiz

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": 4,
    "method": "tools/call",
    "params": {
      "name": "get_quiz_questions",
      "arguments": { "quiz_id": "Customer readiness check" }
    }
  }'

Obtenir les paramètres d'un quiz

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": 8,
    "method": "tools/call",
    "params": {
      "name": "get_quiz_settings",
      "arguments": { "quiz_id": "Customer readiness check" }
    }
  }'

Modifier un quiz

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": 5,
    "method": "tools/call",
    "params": {
      "name": "update_quiz",
      "arguments": {
        "quiz_id": "Customer readiness check",
        "questions": [
          { "text": "Do you have a budget?", "type": "yes_no", "points": 2 },
          { "text": "What's your budget range?", "type": "multiple_choice",
            "options": [
              { "label": "Under $1k", "score": 1 },
              { "label": "$1k-$10k", "score": 2 },
              { "label": "$10k+", "score": 3 }
            ]
          }
        ]
      }
    }
  }'

Publier un quiz en brouillon

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": 6,
    "method": "tools/call",
    "params": {
      "name": "publish_quiz",
      "arguments": { "quiz_id": "Customer readiness check" }
    }
  }'

Obtenir les résultats d'un quiz

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": "Customer readiness check" }
    }
  }'

Supprimer un quiz (avec confirmation)

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": 7,
    "method": "tools/call",
    "params": {
      "name": "delete_quiz",
      "arguments": { "quiz_id": "Customer readiness check", "confirm": true }
    }
  }'

Erreurs#

Les problèmes d'authentification utilisent des codes de statut HTTP avec un corps d'erreur OAuth (RFC 6750) et un en-tête WWW-Authenticate. Les autres erreurs HTTP (endpoint inconnu, limite de requêtes) renvoient application/problem+json (RFC 9457) avec un code stable et une indication. Les problèmes survenus dans un appel d'outil reviennent sous forme de réponse JSON-RPC normale avec isError défini et l'explication dans le texte du contenu.

StatutSignification
401Clé API absente, invalide ou révoquée. Vérifiez l'en-tête Authorization et que la clé existe toujours dans les Paramètres.
400Corps JSON-RPC mal formé. Vérifiez les champs jsonrpc, id, method et params.
404Aucun endpoint à ce chemin. Le corps est en application/problem+json avec le code not_found.
429Limite de requêtes dépassée. Le corps est en application/problem+json avec le code rate_limited ; attendez le nombre de secondes indiqué dans Retry-After.
200 + isErrorL'appel d'outil lui-même a échoué, par exemple un nom ou un ID de quiz qui ne vous appartient pas, un nom de quiz correspondant à plusieurs de vos quiz, la modification d'un quiz publié sans confirm_edit_published: true, la suppression d'un quiz sans confirm: true, ou une question multiple_choice avec moins de 2 options. Le contenu texte explique quoi corriger.

Codes d'erreur (application/problem+json)

Chaque corps de problème contient type, title, status, code et généralement detail et hint. L'URI type renvoie à l'entrée correspondante ci-dessous.

not_found
Le chemin n'est pas un endpoint de l'API. Consultez /openapi.json pour les endpoints documentés.
rate_limited
Trop de requêtes dans la fenêtre actuelle. Attendez Retry-After secondes, puis réessayez.

Limites de requêtes et versionnage#

Chaque clé API ou jeton OAuth peut envoyer 120 requêtes par minute à /api/mcp (les requêtes sans identifiant sont comptées par adresse IP). Chaque réponse contient RateLimit-Policy et RateLimit (format du brouillon IETF) ainsi que RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset, pour que vous puissiez ralentir avant d'atteindre la limite. Au-delà de la limite, vous recevez une erreur 429 avec Retry-After.

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Policy: "default";q=120;w=60
RateLimit: "default";r=0;t=17
Retry-After: 17

{"type":"https://fluotest.com/en/docs/api-reference#error-rate_limited","title":"Too Many Requests","status":429,"code":"rate_limited","hint":"Wait 17 seconds (Retry-After) before retrying."}

Le transport est versionné par l'en-tête de requête MCP-Protocol-Version, négocié pendant initialize. L'ensemble des outils suit le versionnage sémantique (le champ version dans /openapi.json) : les nouveaux outils et les nouveaux arguments facultatifs sont additifs et ne cassent jamais les appels existants.

Un changement incompatible est publié sous un nouveau nom d'outil. L'ancien outil continue de fonctionner pendant au moins 90 jours ; les réponses qui l'utilisent portent un en-tête Deprecation et un en-tête Sunset avec la date de retrait, et le changement est annoncé dans le journal des modifications.

FAQ#

Y a-t-il une limite de requêtes ?

Oui : 120 requêtes par minute par clé API ou jeton OAuth sur /api/mcp. Chaque réponse contient des en-têtes RateLimit avec votre quota restant, et une réponse 429 vous indique combien de temps attendre dans Retry-After.

Puis-je utiliser OAuth au lieu d'une clé API ?

Oui, OAuth est la méthode recommandée pour connecter des assistants IA comme Claude, où l'utilisateur approuve l'accès sur un écran de consentement. Les clés API sont l'option la plus simple pour les scripts et les clients qui envoient simplement des en-têtes. Consultez le guide du serveur MCP pour la configuration OAuth.

Que peut faire l'API aujourd'hui ?

Huit opérations : list_quizzes, create_quiz, get_quiz_questions, get_quiz_settings, update_quiz (avec une étape de confirmation pour modifier les quiz publiés), publish_quiz, get_results et delete_quiz (avec une étape de confirmation). Chaque argument qui désigne un quiz accepte un titre, un slug ou un ID. D'autres opérations sont prévues. Dites-nous ce dont vous avez besoin via le formulaire de retour dans le tableau de bord.