REST API

In brief

Contractual host api.askmarcel.app/v1. Main entry point: POST /diagnostic for a one-shot sourced diagnostic.

Contractual host

https://api.askmarcel.app/v1 is the only prefix to use in production. The equivalent path on the app domain is a non-contractual internal rewrite.

OpenAPI

Machine spec: 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

One-shot sourced search: manual excerpt, steps and citation. For multi-turn Air/Water HP troubleshooting, use 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

Document search in the technical corpus. Required parameter: q.

curl

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

SDKs & templates

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