Documentation développeur

Connecteur générique « Webhook / API »

Exposez deux routes HTTP sur votre propre API pour que l'assistant vocal Subline puisse répondre à « ce produit est-il disponible ? » et « où en est ma commande ? » — sans jamais divulguer de donnée sensible.

Règle d'or.Ne renvoyez qu'un statut grossier. Jamais de prix, quantité exacte, adresse, contenu de commande ni donnée personnelle.

Authentification

Chaque requête porte votre clé (définie dans Subline) :

Authorization: Bearer VOTRE_CLE_API

Clé absente ou invalide → répondez 401. La clé est chiffrée au repos chez Subline et jamais réaffichée.

Disponibilité d'un produit

GET {base}/stock?ref=<REFERENCE_PRODUIT>

200 → { "disponible": true }   // ou false si indisponible

Référence inconnue → { "disponible": false } ou 404.

Statut d'une commande

GET {base}/order?ref=<REFERENCE>&phone=<APPELANT_E164>

200 → { "statut": "en_preparation" | "prete" | "expediee" }

Le paramètre phoneest le numéro de l'appelant (E.164, ex. +33612345678). Utilisez-le pour vérifier l'identité : ne renvoyez un statut que si ce numéro correspond au client de la commande. Pas de correspondance → renvoyez inconnu(ou 404). Toute autre valeur est traitée comme inconnue → l'assistant prend un message.

Robustesse

Timeout 3 s, 2 nouvelles tentatives sur erreur réseau ou 5xx.
Toute erreur (timeout, 4xx, 5xx, JSON illisible) → traitée inconnu: l'appelant obtient toujours une prise de message, jamais une erreur technique.

Exemples

# Disponibilité produit
curl -s -H "Authorization: Bearer VOTRE_CLE_API" \
  "https://api.mon-commerce.fr/stock?ref=PLAQ-AV-207"
# → {"disponible": true}

# Statut de commande (avec vérification du numéro appelant)
curl -s -H "Authorization: Bearer VOTRE_CLE_API" \
  "https://api.mon-commerce.fr/order?ref=CMD-10245&phone=%2B33612345678"
# → {"statut": "prete"}