⚡ API publique

Intégrez RestauAI à vos outils

API REST simple, webhooks événementiels, doc claire. Compatible Zapier, Make, n8n et tous vos outils.

🚀 Démarrer en 3 minutes

1.

Récupérez votre clé API

Dashboard → Intégrations & API → Générer une clé (Pro/Business)

2.

Appelez l'API

Header X-API-Key + endpoint REST

3.

Automatisez

Branchez Zapier, Make, n8n ou votre code maison

📚 Endpoints disponibles

GET/api/public/v1/restaurantPlan : Tous plans

Récupérer les informations publiques d'un restaurant (nom, slug, adresse, horaires, statut)

Paramètres

X-API-KeyheaderVotre clé API (dashboard → Intégrations → API)

Requête (curl)

curl https://restauai.fr/api/public/v1/restaurant \
  -H "X-API-Key: rai_live_xxx..."

Réponse (JSON)

{
  "ok": true,
  "restaurant": {
    "id": "uuid-...",
    "name": "Le Bistrot du Coin",
    "slug": "bistrot-du-coin",
    "address": "12 rue de la Paix, Paris",
    "phone": "+33 1 42 00 00 00",
    "plan": "pro",
    "published": true
  }
}
GET/api/public/v1/ordersPlan : Pro + Business

Lister les dernières commandes de votre restaurant

Paramètres

X-API-KeyheaderVotre clé API
limitqueryMax 100 (défaut: 20)
statusquerypending | preparing | ready | completed | cancelled
sincequeryISO date (ex: 2026-05-01)

Requête (curl)

curl "https://restauai.fr/api/public/v1/orders?limit=50&status=completed" \
  -H "X-API-Key: rai_live_xxx..."

Réponse (JSON)

{
  "ok": true,
  "orders": [
    {
      "id": "uuid",
      "customer_name": "Marie D.",
      "total": 24.50,
      "items": [...],
      "status": "completed",
      "created_at": "2026-05-25T..."
    }
  ]
}
GET/api/public/v1/reservationsPlan : Pro + Business

Lister les réservations

Paramètres

X-API-KeyheaderVotre clé API
datequeryYYYY-MM-DD (filtre par jour)
statusquerypending | confirmed | cancelled

Requête (curl)

curl "https://restauai.fr/api/public/v1/reservations?date=2026-05-26" \
  -H "X-API-Key: rai_live_xxx..."

Réponse (JSON)

{
  "ok": true,
  "reservations": [
    {
      "id": "uuid",
      "name": "Jean Dupont",
      "party_size": 4,
      "date": "2026-05-26",
      "time": "20:00",
      "status": "confirmed"
    }
  ]
}
GET/api/public/active-promosPlan : Pro + Business

Lister les codes promo actifs de votre restaurant

Paramètres

X-API-KeyheaderVotre clé API

Requête (curl)

curl https://restauai.fr/api/public/active-promos \
  -H "X-API-Key: rai_live_xxx..."

Réponse (JSON)

{
  "ok": true,
  "promos": [
    {
      "code": "BIENVENUE10",
      "discount_value": 10,
      "discount_type": "percent",
      "expires_at": "2026-12-31"
    }
  ]
}

🔔 Webhooks événementiels

Plutôt que de poller l'API, recevez des événements en temps réel. Configurez votre URL webhook dansDashboard → Intégrations.

ÉvénementDescription
order.createdNouvelle commande reçue (toutes méthodes : sur place, retrait, livraison)
order.updatedStatut commande modifié (preparing → ready → completed)
reservation.createdNouvelle réservation client
reservation.confirmedRéservation confirmée par le restaurateur
review.createdNouvel avis client publié
payment.succeededPaiement en ligne réussi (Stripe Connect)
payment.refundedCommande remboursée

📊 Quotas & limites

  • Rate limit : 60 requêtes par minute par clé API
  • Pagination : max 100 items par page
  • Webhooks : retry 3 fois si réponse ≠ 200, puis abandon
  • Signature webhooks : header X-RestauAI-Signature (HMAC-SHA256)

Une question, un endpoint manquant ?

Écris-moi à ulyssebiabiany@gmail.com, je code souvent les endpoints demandés dans la semaine.