Fluance Le mouvement qui éveille et apaise

Agent-Ready API

API Fluance

Cette API expose le planning des cours Fluance, le statut d’un pass et la réservation d’une séance. Elle alimente le site, les outils WebMCP du navigateur, un serveur MCP distant et un endpoint A2A.

Endpoints principaux

  • GET /api/courses : liste des cours disponibles avec date, heure, lieu et places restantes. Public.
  • GET /api/course-status?courseId=... : statut détaillé d’un cours. Public.
  • GET /api/status : endpoint santé léger pour discovery automatisée. Public.
  • GET /api/pass-status?email=... : vérifie si une personne dispose d’un pass actif (PII). Clé API (pass:read).
  • POST /api/bookings : crée une réservation, avec ou sans pass. Clé API (booking:write).
  • POST /api/send-contact-email : transmet une demande de contact au support. Clé API (contact:write).

Les routes protégées attendent la clé dans l’en-tête X-API-Key (ou Authorization: Bearer flu_...). Sans clé configurée côté Worker, ces routes répondent 503 ; avec une clé invalide, 401 ; sans le bon scope, 403.

Plateformes d’agents

  • MCP : POST /api/mcp — serveur MCP distant (Streamable HTTP, JSON), outils en lecture seule.
  • A2A : POST /api/a2a — JSON-RPC message/send, agent card sur /.well-known/agent-card.json.
  • GPT Actions : importer openapi.json (opérations de lecture en priorité).
  • Meta AI Connectors : s’appuie sur l’API REST (OpenAPI) et l’onboarding MCP ; OAuth pour l’account linking (roadmap).

Ressources de découverte

  • /.well-known/api-catalog
  • /.well-known/agent-card.json (A2A)
  • /.well-known/mcp/server-card.json
  • /.well-known/agent-skills/index.json et les SKILL.md
  • /.well-known/webmcp-context.json

WebMCP

Les pages Fluance déclarent des outils WebMCP pour :

  • identifier à qui l’approche Fluance peut convenir,
  • lister les cours disponibles,
  • ouvrir le parcours de réservation pour une séance choisie.

État actuel et limites

  • Les pages statiques sont servies par Cloudflare Pages ; les routes /api/* et /.well-known/* sont servies par le Worker Cloudflare fluance-api-proxy, tandis que les Cloud Functions Firebase restent le backend de référence.
  • Les réponses dynamiques de l’API ne sont pas mises en cache.
  • Le serveur MCP est volontairement en lecture seule ; la réservation passe par les routes REST protégées.
  • Aucun endpoint OAuth/OIDC n’est encore publié. C’est un prérequis pour l’account linking (Meta AI Connectors) et les actions authentifiées au nom d’un utilisateur.
  • Le site publie des ressources markdown dédiées aux agents, sans négociation de contenu Accept: text/markdown sur les pages HTML.