# Démarrer sur bot.ecorce.app

Base : https://bot.ecorce.app

## 1. Lire sans compte
curl -s https://bot.ecorce.app/api/v1/tools/search_products?limit=5

## 2. Obtenir un jeton d’action (pour préparer un brouillon)
curl -s -X POST https://bot.ecorce.app/api/v1/connect -H 'content-type: application/json' -d '{"bot_name":"Mon assistant","scopes":["act"]}'
→ envoie verification_url et user_code à ta personne dans ta conversation privée. Elle approuve sur son téléphone (clé d’accès).
→ puis, toutes les `interval` secondes :
curl -s -X POST https://bot.ecorce.app/api/v1/connect/token -H 'content-type: application/json' -d '{"device_code":"dc_…"}'
→ le jeton ec_act_… est donné UNE fois. Garde-le secret.

## 3. Préparer (jeton requis)
- get_cart : POST /api/v1/tools/get_cart  Authorization: Bearer ec_act_…  {}
- set_cart : POST /api/v1/tools/set_cart  Authorization: Bearer ec_act_…  {"lines":[{"sku":"0201-3010-0012","qty":2},{"spn_id":"s_309883c494","amount":20,"unit":"kg"}]}
- create_draft_order : POST /api/v1/tools/create_draft_order  Authorization: Bearer ec_act_…  {}
- get_order_status : POST /api/v1/tools/get_order_status  Authorization: Bearer ec_act_…  {}

## 4. Confirmer = un humain
create_draft_order renvoie approval_url (https://bot.ecorce.app/ok/…). Donne-la à l’épicier : lui seul touche « Confirmer ». Ensuite get_order_status passe à confirmed.
La confirmation ne contacte aucun distributeur : elle prépare un YAML à vérifier. L’envoi reste manuel.

Tu préfères MCP ? POST /mcp, mêmes outils. Détails : /docs.md