Construisez avec RiLoProxy

01 Présentation

L'API publique d'RiLoProxy est une API REST en JSON. Elle expose deux périmètres :

02 Démarrage rapide

1. Créez un compte sur /inscription et connectez-vous.
2. Générez une clé depuis /compte/api (client) ou /pro/api (vendeur). Le token est affiché une seule fois — stockez-le immédiatement.
3. Faites un premier appel :

   curl -H "Authorization: Bearer ep_live_VOTRE_TOKEN" \
        https://enghien.riloweb.be/api/v1/products?limit=5

4. Vérifiez vos quotas sur GET /me.

03 Authentification

Toutes les routes (sauf POST /auth/login) exigent un Bearer token :

Authorization: Bearer ep_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

En dépannage uniquement, le token peut passer en query : ?api_key=ep_live_… (déconseillé en production).

POST /auth/login

Connexion utilisateur en JSON. Limite stricte : 3 tentatives par email/IP toutes les 15 minutes. Au-delà → 429 too_many_attempts avec Retry-After.

curl -X POST https://enghien.riloweb.be/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"client@example.com","password":"secret"}'

Réponse :

{
  "ok": true,
  "token_type": "Bearer",
  "access_token": "ep_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "api_key_prefix": "ep_live_abcd",
  "user": {
    "id": 1,
    "email": "client@example.com",
    "first_name": "Client",
    "last_name": "Demo",
    "role": "customer"
  }
}

Headers de quota

Chaque réponse renvoie les compteurs courants :

X-RateLimit-Quota: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Per-Minute: 5

04 Format des réponses

Toutes les réponses sont en JSON UTF-8 et incluent toujours ok: true|false.

{
  "ok": true,
  "items": [...],
  "total": 42,
  "limit": 50,
  "offset": 0
}

{
  "ok": false,
  "error": "invalid_token",
  "message": "Jeton API invalide ou révoqué.",
  "details": { ... }
}

05 Codes d'erreur

06 Endpoints publics

Consultation du catalogue et de la recherche. Disponibles avec n'importe quelle clé valide.

Paramètres de GET /products

07 Endpoints vendeur

Après POST /auth/login, listez les magasins via GET /shop pour afficher la sélection à l'utilisateur. Si selected_shop est null, l'utilisateur doit choisir un magasin avant d'appeler /shop/{slug}/....

Magasins

Produits

Stock & inventaire

Commandes

StoreServeur

Vidanges / cautions

Promotions

Réservations

Publicité & Sponsorisation

Employés

Champs POST /shop/{slug}/products

Exemple — création produit

curl -X POST https://enghien.riloweb.be/api/v1/shop/rich-lo/products \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Café arabica 250g",
    "price": 8.90,
    "stock": 30,
    "category_id": 2,
    "short_description": "Grains fraîchement torréfiés à Enghien",
    "status": "published"
  }'

Exemple — mise à jour partielle

curl -X PATCH https://enghien.riloweb.be/api/v1/shop/rich-lo/products/42 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "price": 9.50, "stock": 45 }'

Exemple — mouvement d'inventaire

{
  "product_id": 12,
  "type": "in",
  "quantity": 5,
  "reason": "Réception fournisseur",
  "reference": "BL-2026-001"
}

Exemple — remboursement de vidange

POST /shop/rich-lo/deposits/142/refund

{
  "method": "cash",
  "reference": "Rendu en boutique"
}

method accepte cash, card ou stripe. Avec stripe, l'API tente un remboursement partiel du montant de la vidange sur le paiement Stripe de la commande.

Exemple StoreServeur all

curl https://enghien.riloweb.be/api/v1/shop/rich-lo/storeserver/all \
  -H "Authorization: Bearer $TOKEN"

08 Modèle de données

Product

{
  "id": 5,
  "slug": "cafe-arabica-250g",
  "name": "Café arabica 250g",
  "short_description": "Grains fraîchement torréfiés",
  "description": "Texte long…",
  "price": 8.90,
  "compare_at_price": 10.90,
  "sku": "ARAB-250",
  "stock": 30,
  "stock_threshold": 5,
  "category_id": 2,
  "status": "published",
  "is_active": true,
  "reservation_enabled": false,
  "reservation_window_hours": 48,
  "not_deliverable": false,
  "published_at": "2026-04-23 15:00:00",
  "updated_at": "2026-04-23 15:00:00",
  "created_at": "2026-04-23 15:00:00",
  "url": "/produit/cafe-arabica-250g"
}

Order (vue vendeur)

{
  "id": 1042,
  "order_number": "EP-2026-04-01042",
  "status": "preparing",
  "payment_status": "paid",
  "payment_method": "card",
  "subtotal": 32.40,
  "delivery_fee": 4.00,
  "total": 36.40,
  "created_at": "2026-04-23 12:48:00",
  "cancelled_at": null
}

Statuts commande : pending, confirmed, preparing, shipped, delivered, cancelled.

09 Pagination & versioning

Les listes acceptent limit (max 100) et offset. La réponse contient total pour calculer le nombre de pages.

GET /api/v1/products?limit=20&offset=40

Versions

L'URL porte la version (/api/v1). En cas de changement incompatible, une /api/v2 sera introduite en parallèle. Les ajouts rétro-compatibles (nouveaux champs optionnels, nouveaux endpoints) sont déployés en v1 sans préavis.

10 Formules & quotas

Démarrez gratuitement. Passez à une formule payante quand votre produit décolle.

11 Support