Documentation d'intégration

1. Authentification

Chaque requête doit inclure votre clé API. Deux formats sont acceptés :

X-API-Key: bs_live_xxxxxxxxxxxxxxxx
# ou
Authorization: Bearer bs_live_xxxxxxxxxxxxxxxx

Une clé bloquée renvoie 403. Une clé inconnue renvoie 401.

2. Catalogue

Liste des produits disponibles avec votre prix d'achat revendeur.

curl https://banandi-hub.lovable.app/api/public/v1/products \
  -H "X-API-Key: bs_live_xxxx"

{
  "success": true,
  "products": [
    {
      "id": "0f1c…",
      "name": "Exemple de produit",
      "description": "…",
      "price": 12.5,
      "stock": null,
      "delivery_type": "instant"
    }
  ]
}

3. Votre solde

curl https://banandi-hub.lovable.app/api/public/v1/balance \
  -H "X-API-Key: bs_live_xxxx"

{
  "success": true,
  "shop_name": "Mon Shop",
  "balance": 45.80
}

4. Passer une commande

Votre solde est débité immédiatement. En cas d'échec de livraison, le montant est automatiquement remboursé.

curl -X POST https://banandi-hub.lovable.app/api/public/v1/orders \
  -H "X-API-Key: bs_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"0f1c…","quantity":1}'

{
  "success": true,
  "order": {
    "reference": "BS-XXXXXXXX",
    "product_name": "Exemple de produit",
    "quantity": 1,
    "unit_price": 12.5,
    "total_price": 12.5,
    "status": "completed",
    "delivery": { "…": "contenu livré" },
    "created_at": "2026-01-01T12:00:00.000Z"
  },
  "balance": 33.30
}

Erreurs possibles : INSUFFICIENT_BALANCE (solde insuffisant), OUT_OF_STOCK, PRODUCT_NOT_FOUND.

5. Suivre une commande

curl https://banandi-hub.lovable.app/api/public/v1/orders/BS-XXXXXXXX \
  -H "X-API-Key: bs_live_xxxx"

GET /api/public/v1/orders renvoie vos 100 dernières commandes.

Bonnes pratiques

• • Stockez la clé API côté serveur uniquement, jamais dans votre site public.
• • Vérifiez votre solde avant de proposer un produit à la vente.
• • Conservez la référence BS-… de chaque commande.
• • Rechargez votre solde auprès de notre équipe via WhatsApp.