Développeurs et agents IA
Construisez sur Fixou.
L'API REST et le serveur MCP qui permettent à un agent IA de créer une demande de devis pour un client final, puis d'en suivre les réponses d'artisans français.
Le parcours d'un agent
Du besoin exprimé en langage naturel jusqu'aux réponses d'artisans, le chemin passe toujours par une confirmation du client final.
Il explique son problème à son assistant IA, en langage naturel : « j'ai une fuite sous mon évier à Marseille ».
L'agent identifie le métier, complète le questionnaire et appelle l'API avec l'email du client final.
Il reçoit « Confirmez votre demande » et clique sur le lien, valable 48 h. Ce clic, et lui seul, publie la demande.
La demande part aux artisans du secteur. Le client suit les réponses et échange avec eux sur son espace fixou.fr.
Deux voies d'intégration
Les mêmes capacités, exposées de deux manières : une API REST classique, ou un serveur MCP à brancher directement dans un assistant.
API REST
Trois endpoints décrits par une spécification OpenAPI 3.1. On s'authentifie avec une clé Bearer préfixée fixou_sk_, transmise dans l'en-tête Authorization.
Serveur MCP
Un serveur Model Context Protocol sur https://mcp.fixou.fr/mcp, sans clé côté client, publié au registre officiel sous fr.fixou/fixou. À brancher dans Claude ou ChatGPT comme connecteur personnalisé.
Créer une demande en un appel
Un POST /api/v1/requests enregistre la demande au statut pending_confirmation. Aucun artisan n'est contacté tant que le client final n'a pas confirmé par email.
curl -X POST https://fixou.fr/api/v1/requests \
-H "Authorization: Bearer fixou_sk_..." \
-H "Content-Type: application/json" \
-d '{
"categorySlug": "plombier",
"answers": { "type": "fuite", "lieu": "cuisine", "urgence": "urgent" },
"description": "Fuite sous le lavabo de la cuisine, intervention rapide souhaitee.",
"postalCode": "13001",
"email": "[email protected]"
}'Exemple complet et directement exécutable, aligné sur la référence REST.
Prêt à démarrer ?
Aucun artisan n'est jamais contacté sans la confirmation par email du client final : le double opt-in protège vos utilisateurs et la qualité du réseau.