# Générateur de jeux promotionnels Créez une roue, une carte à gratter ou une boîte mystère. Démo locale ou API du marchand, sans service de remise de lots. > Page canonique: https://elysiatools.com/fr/tools/store-promotion-giveaway-widget-generator - **Catégorie:** Design - **Mots-clés:** Générateur de jeux promotionnels, Roue de la chance, Carte à gratter, Boîtes mystère ## Présentation ## Atelier de campagne Créez une roue, une carte à gratter ou une boîte mystère. Démo locale ou API du marchand, sans service de remise de lots. - Composant: Roue de la chance / Carte à gratter / Boîtes mystère - Thème: Minimalisme côtier / Bonbon pop / Arcade rétro / Or de minuit / Papier de fête / Croquis de jardin ### Source du résultat Le tirage local est modifiable et ne sécurise pas la remise des lots. Les offres du code sont publiques. Aucun contrôle de stock, identité ou participations répétées. Votre serveur gère authentification, probabilités, stock, admissibilité et idempotence. Aucune clé secrète ici. L’aperçu n’appelle jamais votre API. ### Guide d’intégration de l’API Il s’agit d’un contrat d’interface, pas d’un service de tirage Elysia. Implémentez POST /api/draw sur votre serveur avec les mêmes identifiants de campagne et de lots, puis indiquez l’API. Hébergez les fichiers sur HTTPS pour tester les vrais tirages ; l’éditeur les simule uniquement. #### Requête · POST application/json Le widget transmet uniquement version, campaignId et un requestId hexadécimal aléatoire de 32 caractères. Aucun identifiant client, probabilité ou clé API. Le serveur doit identifier le participant ; requestId n’est pas un moyen d’authentification. ```json { "version": 1, "campaignId": "summer-boutique", "requestId": "0123456789abcdef0123456789abcdef" } ``` #### Succès · 200 application/json Renvoyez requestId à l’identique. prizeId doit correspondre à un lot configuré, y compris sans gain. Facultatifs : receiptId (≤200 caractères), claim.code (≤300), claim.url (HTTPS, ≤2048). Omettez les champs inutilisés, sans null. Aucune enveloppe data/result ; maximum 16 KiB. Une erreur n’est pas un résultat perdant. ```json { "requestId": "0123456789abcdef0123456789abcdef", "prizeId": "p1", "receiptId": "draw_2026_001", "claim": { "code": "SAMPLE-ONLY", "url": "https://shop.example/redeem" } } ``` Identifiants des lots: - `p1`: 10 % de réduction - `p2`: Livraison offerte - `p3`: Cadeau mystère - `p4`: Une prochaine fois Hébergez de préférence le widget et /api/draw sur la même origine (protocole, hôte, port), avec un proxy inverse si nécessaire. Les chemins sont relatifs au widget, pas à la boutique parente. credentials: same-origin transmet uniquement les cookies de même origine. Aucun en-tête Authorization ou personnalisé configurable. Une autre origine nécessite CORS pour le widget et OPTIONS pour POST + Content-Type ; aucun cookie interorigine n’est transmis. Un HTML statique ne suffit pas pour un tirage authentifié ; les cookies tiers des iframes peuvent être bloqués. Le serveur authentifie, vérifie Origin/CSRF et l’admissibilité, limite participations et débit, utilise ses propres probabilités et réserve le stock avec le résultat dans une transaction. Persistez l’idempotence par participant + campaignId + requestId pour renvoyer le même résultat. Contrôlez retrait et expiration côté serveur. Les données du navigateur ne prouvent aucun droit ; ne publiez aucun secret. Refusez les requêtes avec un statut non 2xx (ex. 401/403/409/429/503). Le widget affiche un message générique, pas l’erreur serveur. Délai de 15 secondes ; redirections, JSON invalide, requestId différent, lots inconnus et liens dangereux sont refusés. La reprise manuelle conserve l’ID uniquement sur cette page ; recharger le change, donc les limites doivent être persistantes. Ni reprise automatique ni lot local de secours. L’aperçu reste actif si les adresses API ou d’hébergement sont incomplètes. Corrigez les champs indiqués pour exporter ; une erreur de lot ou de style conserve le dernier aperçu valide. ### Exporter et intégrer HTML / CSS / JavaScript / JSON. Hébergez les fichiers sur votre site HTTPS, puis collez l’URL. Cet outil ne publie ni n’héberge de campagnes. Les images facultatives proviennent de leurs hôtes HTTPS. L’éditeur ne stocke ni images ni clés API. Les secteurs égaux sont visuels ; les probabilités règlent la démo. En mode API, le serveur décide. ## Entrées - **Configuration JSON** (textarea) ## Quand l'utiliser - Vous souhaitez animer une opération commerciale avec une roue interactive ou un jeu à gratter sans dépendre d'une plateforme tierce payante. - Vous devez connecter un widget d'animation marketing frontend à votre propre API marchande pour sécuriser l'attribution des codes et des stocks. - Vous voulez tester rapidement l'ergonomie, les thèmes graphiques et les libellés de lots d'un jeu concours avant son intégration en production. ## Fonctionnement - Renseignez la configuration JSON en définissant le composant interactif (roue, carte à gratter ou boîte mystère), le thème visuel, les couleurs et les libellés de l'opération. - Sélectionnez le mode de tirage : le mode local pour une démonstration immédiate basée sur des probabilités déclarées, ou le mode API pointant vers votre endpoint HTTPS sécurisé. - Définissez le catalogue des lots avec leurs identifiants uniques, leurs messages d'attribution et, le cas échéant, l'option sans gain. - Validez la configuration pour générer le récapitulatif technique et exportez les fichiers HTML, CSS, JavaScript et JSON pour les héberger sur votre propre serveur. ## Cas d'usage - Création d'une roue de réduction saisonnière intégrée dans une boutique e-commerce pour dynamiser le panier moyen. - Mise en place d'une carte à gratter promotionnelle reliée à l'API d'un programme de fidélité pour distribuer des avantages uniques. - Conception d'une boîte mystère événementielle autonome pour présenter des offres partenaires lors d'un salon ou d'une opération éphémère. ## Questions fréquentes ### Le tirage en mode local est-il sécurisé contre la triche ? Non. Le mode local simule le tirage directement dans le navigateur du visiteur ; les codes et probabilités y sont visibles et modifiables. ### Comment sécuriser l'attribution réelle des lots avec mon API ? Passez en mode API et implémentez un endpoint POST renvoyant le requestId fourni et le prizeId validé après vérification d'éligibilité côté serveur. ### L'éditeur exécute-t-il des requêtes vers mon serveur pendant la prévisualisation ? Non, l'aperçu fonctionne hors ligne et ne contacte jamais votre endpoint ; les vrais tirages s'exécutent une fois les fichiers exportés et hébergés sur HTTPS. ### Quels types de composants interactifs sont disponibles ? Vous pouvez générer une roue de la chance (wheel), une carte à gratter (scratch) ou des boîtes mystères (boxes). ### Ce générateur héberge-t-il les campagnes ou les images des lots ? Non. L'outil génère le code à auto-héberger sur vos serveurs ; les images optionnelles doivent être servies depuis leurs propres URL HTTPS. ## Outils associés - [Generateur de cascade de color tokens](https://elysiatools.com/fr/tools/color-token-cascade-generator): Transforme un hex principal en systeme complet de tokens, variables CSS et JSON Style Dictionary - [De la palette d’image aux design tokens](https://elysiatools.com/fr/tools/image-to-design-tokens): Extrait les couleurs dominantes d’une image par k-means et les exporte en variables CSS / SCSS / config Tailwind / tokens JSON, avec noms et échelle de teintes - [Generateur de Snippets de Requetes API](https://elysiatools.com/fr/tools/api-request-code-snippet-generator): Genere du cURL et des snippets dans des langages courants a partir d une URL, methode, en-tetes, query et body - [Planificateur de migration CSV vers base de donnees](https://elysiatools.com/fr/tools/csv-to-database-migration-planner): Infere un schema relationnel a partir dun CSV et genere CREATE TABLE et ALTER pour PostgreSQL, MySQL, SQLite ou SQL Server - [Generateur PDF de programme fitness](https://elysiatools.com/fr/tools/fitness-workout-pdf-generator): Genere un PDF imprimable dentrainement depuis JSON ou CSV avec tableaux, cases de suivi et QR optionnels - [Studio de README de profil GitHub](https://elysiatools.com/fr/tools/github-profile-readme-studio): Générez un README de profil complet — bannière, tuiles de statistiques, carte thermique, skyline 3D et cartes de projets — cuits une fois en assets SVG statiques et thémables. Aucun service de badges susceptible de tomber. - [OpenAPI vers Postman Collection](https://elysiatools.com/fr/tools/openapi-to-postman-collection): Convertit une spec OpenAPI 3.x ou Swagger 2.0 (JSON/YAML) en Postman Collection v2.1.0 importable avec dossiers, variables, auth et réponses d'exemple. - [Generateur OpenAPI vers TypeScript](https://elysiatools.com/fr/tools/openapi-to-typescript-generator): Convertit des specifications OpenAPI ou Swagger JSON/YAML en types TypeScript, parametres de requete et modeles de reponse avec format et style de nommage configurables ## Exemples - [Exemples de Traçage Distribué](https://elysiatools.com/fr/samples/distributed-tracing-samples): Exemples complets de traçage distribué utilisant Jaeger, OpenTelemetry et outils d'observabilité modernes - [Exemples AWS EventBridge](https://elysiatools.com/fr/samples/eventbridge-samples): Exemples AWS EventBridge incluant les bus d'événements, règles, cibles, registre de schémas, événements personnalisés et routage d'événements inter-comptes pour l'architecture serverless event-driven - [Exemples JWT](https://elysiatools.com/fr/samples/jwt-samples): Exemples complets de JWT de la structure de base des tokens aux implémentations de sécurité avancées - [Exemples PDF](https://elysiatools.com/fr/samples/pdf-samples): Exemples PDF generes par les outils du 2026-02-01 au 2026-02-10 ## Contenu associé - [Revue et livraison d’un module de jeu promotionnel auto-hébergé](https://elysiatools.com/fr/hubs/self-hosted-giveaway-widget-review-and-embed-handoff): Contrôlez configuration, exemples de réponses, lisibilité et affichage adaptatif avant de livrer les fichiers du module et les preuves de recette de son intégration.