Démarrage rapide

En bref

Trois étapes : obtenir une clé ak_live_, envoyer un diagnostic, lire la réponse JSON sourcée. Hôte contractuel : api.askmarcel.app/v1.

1. Créer une clé Developer

Rendez-vous sur https://app.askmarcel.app/developers, connectez-vous et créez une clé secrète (préfixe ak_live_). Le palier Developer inclut 250 requêtes/mois — suffisant pour un POC.

2. Appeler POST /v1/diagnostic

Envoyez marque, modèle et code erreur. L'API renvoie étapes, pièce SAV et citation constructeur (manuel, page, section).

curl -s https://api.askmarcel.app/v1/diagnostic \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"brand":"Mitsubishi","model":"Ecodan PUHZ-W85","error_code":"E7"}'

3. Lire la réponse

Chaque réponse inclut steps[], source (manuel, page, section), confidence et éventuellement part (référence pièce). Affichez tel quel dans votre UI ou passez à votre agent.

Réponse exemple

{
  "diagnostic": "Défaut de communication unité intérieure/extérieure",
  "steps": [
    "Contrôler le bornier S1-S2-S3 (continuité)",
    "Vérifier la polarité de la liaison (non inversée)"
  ],
  "part": { "label": "Carte de communication" },
  "source": {
    "manual": "Manuel installateur Ecodan",
    "page": 34,
    "section": "5.2"
  },
  "confidence": { "score": 0.97, "level": "high" }
}

Et ensuite ?

Référence complète : https://api.askmarcel.app/v1/openapi.json
Connexion agent IA : voir la page MCP
Intégration plateforme : Claude Desktop, n8n, Make…