Glossaire de l’API Slots : fournisseur, portefeuille, manche, RTP et certification

En bref

Le problème de terminologie le plus difficile dans un projet d’API Slots n’est que rarement que personne ne connaisse un terme. Il tient plutôt au fait que différentes équipes utilisent le même terme pour des objets différents. Par exemple, « disponible » peut vouloir dire répertorié dans un catalogue, connecté en préproduction, activé en production ou vérifié pour un marché cible. Des définitions stables permettent de rattacher les questions d’achats, la conception d’interface, les preuves de test et les décisions de production au même périmètre de faits.

Cette page fournit des définitions concises réutilisables sur l’ensemble du site. Pour les méthodes complètes de sélection, d’acceptation, de fiabilité et de vérification de marché, suivez les guides thématiques au lieu de considérer ce glossaire comme un tutoriel d’implémentation.

Rôles fondamentaux et concepts de catalogue

Terme	Définition concise	Ce qu’il n’établit pas
Fournisseur / fournisseur de jeux	Une partie qui fournit du contenu de jeu, des services de jeu ou des interfaces associées.	Qu’AG détient les droits de distribution, ou que le contenu est disponible sur un marché particulier.
Agrégateur	Une couche d’intégration qui normalise ou coordonne l’accès entre une plateforme et plusieurs fournisseurs.	Que les différences entre fournisseurs, conditions commerciales, certifications ou examens de marché disparaissent.
Plateforme	Un système métier qui gère les comptes joueurs, les portefeuilles, les opérations ou l’expérience front-end.	Qu’elle est le fournisseur, le RGS ou l’opérateur juridiquement responsable dans une juridiction donnée.
Opérateur / entité exploitante	L’entité responsable des opérations dans un périmètre de projet ou de marché spécifié ; sa signification exacte dépend du contrat et de la juridiction.	Que la connexion d’une API accorde une autorisation d’exploitation.
RGS / Remote Game Server	Un composant système qui héberge ou coordonne le fonctionnement à distance du jeu, son état et les interactions de transaction associées.	Qu’il s’agit de l’agrégateur, ou que des systèmes portant des noms similaires ont le même périmètre de certification.
Catalogue / catalogue de jeux	Une collection d’enregistrements de jeux avec informations de provenance, d’identité, de version, d’état et d’examen.	Que l’inclusion dans le catalogue signifie un inventaire en temps réel, une activation en production ou une admission sur un marché.
ID d’enregistrement de catalogue	Un identifiant interne qui suit de façon cohérente un enregistrement de catalogue.	Qu’il remplace un code de jeu fournisseur ou un ID de transaction.
Code de jeu fournisseur	Le code utilisé par un fournisseur ou une interface amont pour identifier un jeu de manière unique.	Qu’il puisse être déduit d’un nom d’affichage ou d’un slug de page.
Version du jeu	Une version identifiable du logiciel de jeu ou d’une build de contenu.	Qu’elle soit identique à la version du modèle mathématique.
Version du modèle mathématique	La version du modèle mathématique régissant les probabilités, les gains et les caractéristiques statistiques théoriques.	Qu’une interface inchangée signifie que le modèle n’a pas changé.

Sessions, manches et transactions

Terme	Définition concise	Ce qu’il n’établit pas
Lancement	Le processus par lequel une plateforme demande et ouvre un jeu spécifié au moyen de paramètres convenus.	Que la réception d’un résultat de lancement achève le flux de jeu ou l’examen du marché cible.
URL de lancement	Une URL d’entrée du jeu, ou une adresse contenant un jeton, générée pour un contexte de lancement particulier.	Qu’il s’agisse d’un lien public permanent ou qu’elle puisse être divulguée et réutilisée hors du périmètre convenu.
Session de jeu	Un contexte d’interaction délimité, pour un utilisateur, un jeu et un environnement identifiés après l’entrée dans le jeu.	Qu’il s’agisse du compte joueur, de la session de connexion, du portefeuille ou d’une manche.
Manche	Une unité métier qui regroupe un ou plusieurs événements de mise et de résultat conformément aux règles du jeu.	Qu’une manche corresponde toujours à une transaction.
Transaction	Un enregistrement métier traçable qui modifie un solde ou un état métier.	Qu’un succès d’API signifie que tous les systèmes ont atteint une cohérence finale.
Mise	Un type de transaction qui demande ou confirme la déduction d’une mise dans une manche spécifiée.	Qu’une animation côté client prouve que le débit a réussi.
Gain	Un type de transaction qui augmente un solde ou crée un montant payable à partir d’un résultat confirmé.	Un résultat dans une autre manche ou un retour à long terme pour un joueur.
Remboursement	Un retour fondé sur les règles de tout ou partie de l’effet d’une transaction existante.	Que la suppression de la transaction d’origine soit une implémentation acceptable.
Annulation / contrepassation	Une opération traçable qui compense un effet métier existant.	Qu’une demande de remboursement arbitraire puisse être rejouée ; elle doit référencer l’objet d’origine et préserver l’idempotence.
Solde	L’état monétaire utilisé pour une décision métier concernant un compte, une devise et un instant déterminés.	Qu’une seule lecture prouve que tous les enregistrements asynchrones sont rapprochés.
Devise	L’unité monétaire et les règles de précision utilisées pour l’affichage, les mises, le règlement ou le reporting.	Que la prise en charge technique de la devise établisse une autorisation de marché cible.

Concepts de portefeuille et de fiabilité

Terme	Définition concise	Ce qu’il n’établit pas
Portefeuille unique	Un modèle dans lequel la plateforme gère le solde du joueur et les transactions de jeu collaborent avec le portefeuille de la plateforme au moyen d’API en temps réel.	Que les délais d’attente, doublons, états inconnus et exigences de rapprochement disparaissent.
Portefeuille de transfert	Un modèle dans lequel les fonds circulent entre des portefeuilles côté plateforme et côté jeu, et sont enregistrés séparément.	Que les deux soldes soient intrinsèquement cohérents en temps réel.
Rappel	Une interaction de serveur à serveur par laquelle une partie notifie à une adresse convenue un événement ou demande un traitement métier.	L’ordre d’arrivée, l’unicité ou une livraison exactement une fois, sauf si le protocole le prévoit.
Idempotence	La propriété selon laquelle le traitement répété de la même demande métier ne crée pas un effet métier en double.	Le simple renvoi de la même réponse ; le système doit reconnaître la même intention et préserver le résultat pertinent.
Clé d’idempotence	Une clé stable utilisée pour identifier la même demande métier.	Que la clé puisse être régénérée à chaque nouvelle tentative ou réutilisée indéfiniment sans périmètre.
Nouvelle tentative	Une autre tentative, avec des conditions, un nombre et une politique de backoff limités, lorsque l’achèvement n’a pas été établi.	Qu’un délai d’attente équivaille à un échec ; une nouvelle tentative non sûre peut créer un effet en double.
État inconnu	Un état dans lequel l’appelant ne peut déterminer, à partir de la réponse actuelle, si l’action métier s’est achevée.	Que le système puisse immédiatement déclarer un succès ou un échec ; il doit consulter, relancer de manière sûre selon une sémantique explicite ou effectuer un rapprochement.
ID de corrélation	Un identifiant de traçage reliant les demandes, rappels, journaux et enregistrements entre systèmes.	Qu’il remplace un ID de transaction métier ou une clé d’idempotence.
Rapprochement	Le processus de comparaison d’enregistrements indépendants de transactions, manches ou soldes afin d’identifier et de résoudre les écarts.	L’idempotence en temps réel, la consultation de l’état ou les contrôles d’exception.
État final	Un état métier que le protocole définit comme ne changeant plus dans le processus normal.	Qu’une réponse HTTP de succès soit elle-même l’état métier final.

Environnements, versions et preuves de marché

Terme	Définition concise	Ce qu’il n’établit pas
Préproduction	Un environnement et une configuration hors production utilisés pour l’intégration, la vérification et l’acceptation.	Qu’une réussite en préproduction signifie que la production est déployée ou que le comportement métier réel est vérifié.
Production	L’environnement qui traite le trafic et les données réels autorisés.	Qu’une URL ou un identifiant d’accès de production signifie que chaque jeu, marché et version est approuvé.
Version d’API	Une version identifiable des contrats d’interface, champs et comportements.	Que la version du jeu ou du modèle mathématique soit la même.
Version d’intégration	Un enregistrement versionné de la topologie et de la configuration choisies entre la plateforme, l’agrégateur, le RGS et le fournisseur.	Que d’anciennes preuves continuent de s’appliquer après le changement d’un composant critique.
RTP / retour au joueur	Le retour moyen théorique sur un grand nombre d’événements, selon des règles de jeu définies et un modèle mathématique spécifié.	Un résultat pour un événement, une période courte ou un joueur individuel.
RNG / générateur de nombres aléatoires	Un composant ou mécanisme qui fournit des valeurs aléatoires pour les résultats de jeu ou des processus aléatoires associés.	Que son implémentation, sa version ou sa certification ait été vérifiée parce que le RNG est simplement mentionné.
Certification / preuve de conformité	Une preuve de test ou de conformité produite par un organisme spécifié pour un objet, une version, des exigences et un périmètre définis.	Une licence mondiale, ou la couverture automatique d’une entité exploitante, d’une marque, d’un domaine ou d’une nouvelle version.
Certification d’intégration	Une preuve de conformité pour une combinaison et un périmètre d’interaction spécifiés impliquant des composants tels que la plateforme, le RGS, l’agrégateur et le fournisseur.	Tous les autres examens requis pour un jeu individuel ou une entité exploitante.
Organisme de test	Une organisation qui réalise des tests ou émet des rapports dans un périmètre de reconnaissance défini.	Que tous les services et rapports de cet organisme relèvent de la reconnaissance d’un régulateur.
Norme	Une spécification décrivant des exigences techniques, de test ou de contrôle.	Que l’application d’une norme de laboratoire telle que GLI-19 accorde automatiquement l’admission juridictionnelle.
Disponibilité sur le marché	Un état délimité formé à partir du marché cible, de l’entité exploitante, du jeu et de la version, de la certification, de la devise, de la langue, des droits et d’une décision de projet.	Une conclusion que l’inclusion dans le catalogue, la langue, la devise ou la connectivité API peuvent établir seules.
Prise en charge linguistique	Une capacité linguistique vérifiée pour une interface, des règles, une aide ou un périmètre de communication définis.	Une traduction complète, une certification valide ou une disponibilité sur le marché.

Note de périmètre non vérifié pour RTP 0–1000 Cette plage numérique n’est pas la définition du RTP dans ce glossaire. Elle exige toujours des définitions de son unité et de sa signification, de la version du modèle mathématique, des autorisations d’accès, du matériel de test et de certification, du marché cible et de la présentation. Elle ne doit pas être interprétée comme une affirmation vérifiée de performance, de retour ou de conformité au marché.

Ambiguïtés courantes à éliminer

Déclaration ambiguë	Faits à séparer
« Il est dans le catalogue, donc il est disponible. »	Répertorié, vérifié en préproduction, activé en production, disponible commercialement et vérifié pour le marché cible
« La demande a expiré, donc elle a échoué. »	Résultat de transport inconnu, état métier inconnu, échec confirmé, nouvelle tentative sûre et exigence de rapprochement
« Une manche équivaut à une transaction. »	Une manche est une unité métier du jeu ; mise, gain, remboursement et annulation peuvent être des transactions distinctes
« Le BRL et le portugais sont pris en charge, donc le Brésil est prêt. »	Devise, langue, version du jeu, topologie d’intégration, certification, entité exploitante, marque ou domaine et règles de marché
« Il existe une certification, donc cela fonctionne dans le monde entier. »	Reconnaissance de l’organisme de test, norme, objet testé, version, juridiction, validité et conditions du projet

Ce qui peut actuellement être évalué sur ce site

La référence API publique utilise notamment les concepts de catalogue, lancement, portefeuille unique, portefeuille de transfert, enregistrements et processus d’intégration.
Les guides de fiabilité expliquent pourquoi les demandes en double, délais d’attente, échecs de rappel, états inconnus et rapprochement appartiennent à une même conception.
Ce glossaire crée des définitions concises pour une utilisation sur l’ensemble du site, sans ajouter de points de terminaison, méthodes de signature, identifiants d’accès ou faits de protocole de production.
Le catalogue présente 11 fournisseurs et 1 194 noms de jeux. Il s’agit d’un instantané au niveau des noms — pas d’une conclusion sur l’approvisionnement en temps réel, l’activation de production, les droits de contenu, les versions, la certification ou la disponibilité sur le marché cible.

Limites à garder à l’esprit

Aucun champ d’API précis, protocole de production, implémentation de portefeuille, niveau de performance, SLA ou date de sortie n’est promis.
Aucun jeu, fournisseur, certificat, langue ou devise n’est promis comme étant actuellement disponible sur un marché cible.
Ces définitions générales ne remplacent pas un contrat, une spécification d’interface, une règle réglementaire ou une approbation de projet.
L’expression métier RTP 0–1000 est conservée comme terme délimité, mais ne représente pas une définition numérique vérifiée, une capacité universelle, un résultat joueur ou un fait d’admission sur un marché.

FAQ

Un fournisseur et un agrégateur sont-ils le même type d’entreprise ?

Ce sont des rôles différents. Un fournisseur fournit principalement du contenu ou des services de jeu ; un agrégateur coordonne l’accès entre plusieurs fournisseurs et une plateforme. Une même entreprise peut assurer plusieurs rôles, mais les enregistrements du projet doivent toujours distinguer ses responsabilités réelles.

Le rappel, la transaction et la manche doivent-ils utiliser le même ID ?

Ils ne doivent normalement pas être fusionnés en un seul identifiant. Un rappel est un mécanisme d’interaction, une transaction est un changement d’état métier et une manche est une unité métier de jeu. Chacun a besoin d’une identité stable, les ID de corrélation les reliant dans le cadre du contrat d’interface.

Le RTP signifie-t-il qu’un joueur reçoit ce pourcentage à chaque fois ?

Non. Le RTP est une mesure statistique théorique à long terme, selon des règles et un modèle mathématique spécifiés. Il ne garantit pas un résultat pour un événement ou à court terme. Toute valeur numérique nécessite aussi une version de jeu et de modèle mathématique, des preuves de test et un périmètre de présentation.

Lectures associées et prochaines étapes

Les sept premiers guides couvrent l’ensemble des questions qui sous-tendent ces définitions :

Qu’est-ce qu’une API Slots multi-fournisseurs ? — les objets et limites reliés par l’agrégation.
API d’agrégateur ou intégration directe avec le fournisseur — les compromis entre les voies d’intégration.
Comment évaluer un fournisseur d’API Slots — les preuves d’achats et les questions de diligence raisonnable.
De la préproduction à la production — les preuves nécessaires à une décision de production.
Idempotence, nouvelles tentatives et rapprochement — traitement des défaillances, doublons et états inconnus.
Gouvernance des données de catalogue de jeux — champs, états de cycle de vie, versions et responsabilité.
Matrice marché, jeu, version et certification — vérification du marché cible par objet et périmètre.

Pages principales : référence API publique, catalogue de jeux et processus d’intégration.

Lorsque vous utilisez la section « Contactez-nous », décrivez le marché cible, le périmètre du catalogue, le modèle de portefeuille, l’environnement et les versions à l’aide de ces termes. AG pourra alors confirmer la terminologie et le périmètre de preuve avant une discussion de projet. Ceci ne constitue pas un engagement de fourniture, de certification ou de production.

Sources et périmètre

Les sources réglementaires et de normes servent à expliquer la terminologie. Elles ne prouvent pas qu’un projet a satisfait aux exigences mentionnées. Pour un projet particulier, confirmez que chaque définition correspond à l’interface, au contrat et aux règles actuelles du marché cible.

Transformer ce guide en plan de projet ?

Ce contenu aide à préparer une évaluation. Il ne remplace pas la confirmation technique, contractuelle, de certification ou de droit local applicable au projet.

Contacter AG GAME