Connectez vos jeux & fidélité à votre site

L'API WheelWin permet à votre propre site web (page vitrine, site de commande…) de récupérer automatiquement les jeux et le programme de fidélité de votre restaurant, et de les afficher directement chez vous. Deux façons de l'utiliser :

Widget « clé en main »

Une ligne de code : le widget affiche automatiquement vos jeux et votre carte de fidélité. Aucun développement.

Voir le widget →

API REST (JSON)

Pour les développeurs : récupérez les données en JSON et construisez votre propre affichage.

Voir les endpoints →

Authentification

Chaque requête utilise votre clé publique pk_live_…, générée depuis votre espace client (onglet API). La clé publique ne donne accès qu'en lecture aux données publiques (jeux, fidélité) — aucune donnée sensible.

Passez la clé de l'une de ces 3 façons :

Authorization: Bearer pk_live_xxxxxxxx      (recommandé, serveur)
X-API-Key: pk_live_xxxxxxxx                 (header alternatif)
?key=pk_live_xxxxxxxx                        (query, pratique côté navigateur)

Vous pouvez restreindre chaque clé à des domaines précis (ex. https://mon-restaurant.fr) depuis votre espace client.

Démarrage rapide

Un seul appel /bootstrap renvoie tout ce dont votre site a besoin :

curl "https://wheelwin.pages.dev/api/v1/public/bootstrap?key=pk_live_VOTRE_CLE"

Réponse (extrait) :

{
  "ok": true,
  "restaurant": { "name": "Le Gourmet", "slug": "le-gourmet", "primary_color": "#e11d48", "logo_url": null },
  "games": [
    { "id": 12, "type": "wheel", "name": "Roue de Noël", "slug": "roue-de-noel",
      "play_url": "https://wheelwin.pages.dev/jeu/le-gourmet/roue-de-noel",
      "embed_url": "https://wheelwin.pages.dev/embed/jeu/le-gourmet/roue-de-noel" }
  ],
  "loyalty": { "enabled": true, "rewards": [ { "label": "Café offert", "cost_points": 100, "icon": "☕" } ] },
  "stamp_card": { "title": "10 cafés = 1 offert", "stamps_required": 10, "reward_label": "Café gratuit" },
  "player_space_url": "https://wheelwin.pages.dev/mon-espace"
}

Widget « clé en main »

Copiez-collez ce code dans votre page HTML, à l'endroit où vous voulez afficher vos jeux et votre fidélité. Remplacez simplement la clé par la vôtre :

<!-- Widget WheelWin -->
<div data-wheelwin="pk_live_VOTRE_CLE"></div>
<script src="https://wheelwin.pages.dev/static/embed.js" async></script>

Options (attributs)

data-wheelwin — votre clé publique (obligatoire)
data-show="games,loyalty,stamp" — sections à afficher
data-lang="fr" — langue (fr/en)
data-layout="grid" — grid ou list

Ce que le widget affiche

Vos jeux actifs (boutons « Jouer »)
Votre carte à tampons
Vos récompenses fidélité
Un lien vers l'espace joueur

Endpoints REST

GET

/api/v1/public/ping

Test de disponibilité (sans clé).

GET

/api/v1/public/bootstrap

Tout en un appel : restaurant + jeux + fidélité + carte à tampons.

GET

/api/v1/public/restaurant

Infos publiques du restaurant (nom, couleur, logo, liens de commande).

GET

/api/v1/public/games

Liste des jeux actifs (avec play_url et embed_url).

GET

/api/v1/public/games/:slug

Détail d’un jeu + lots visibles.

GET

/api/v1/public/loyalty

Programme de points et barème de récompenses.

GET

/api/v1/public/stamp-card

Configuration de la carte à tampons.

Intégrer un jeu en iframe

Utilisez l'embed_url renvoyée pour chaque jeu :

<iframe src="https://wheelwin.pages.dev/embed/jeu/le-gourmet/roue-de-noel"
        style="width:100%;height:640px;border:0;border-radius:16px"
        allow="clipboard-write"></iframe>

API WheelWin v1 · Base : https://wheelwin.pages.dev/api/v1/public