API REST

En bref

Hôte contractuel api.askmarcel.app/v1. Point d'entrée principal : POST /diagnostic pour un diagnostic sourcé en un aller-retour.

Hôte contractuel

https://api.askmarcel.app/v1 est le seul préfixe à utiliser en production. Le chemin équivalent sur le domaine app est une réécriture interne non contractuelle.

OpenAPI

Spécification machine : https://api.askmarcel.app/v1/openapi.json

Endpoints

POST https://api.askmarcel.app/v1/diagnostic
POST https://api.askmarcel.app/v1/diagnostic/turn
GET https://api.askmarcel.app/v1/search
GET https://api.askmarcel.app/v1/procedure/:chunkId
GET https://api.askmarcel.app/v1/error-codes/:brand/:code
GET https://api.askmarcel.app/v1/products/:brand/:model
GET https://api.askmarcel.app/v1/pdf-snapshot/:documentId/:page
GET https://api.askmarcel.app/v1/registry
GET https://api.askmarcel.app/v1/me

POST /diagnostic

Recherche sourcée en un aller-retour : extrait de manuel, étapes et citation. Pour un dépannage multi-tours PAC Air/Eau, utiliser POST /diagnostic/turn.

curl

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

GET /search

Recherche documentaire dans le corpus technique. Paramètre q obligatoire.

curl

curl -s "https://api.askmarcel.app/v1/search?q=defaut+communication+mitsubishi" \
  -H "Authorization: Bearer ak_live_..."

SDK & templates

npm @askmarcel/sdk (JS/TS)
pip askmarcel (Python)
Template chatbot open-source (HVAC-Bench)