{"id":4540,"date":"2026-10-06T11:31:44","date_gmt":"2026-10-06T11:31:44","guid":{"rendered":"https:\/\/whitelotto.com\/?p=4540"},"modified":"2026-10-07T05:26:42","modified_gmt":"2026-10-07T05:26:42","slug":"lottery-draw-results-api-integration","status":"publish","type":"post","link":"https:\/\/whitelotto.com\/fr\/lottery-draw-results-api-integration\/","title":{"rendered":"API de loterie : tirages, r\u00e9sultats et r\u00e8glement"},"content":{"rendered":"\n

L\u2019int\u00e9gration d\u2019une API de tirages et de r\u00e9sultats de loterie doit conserver le lien entre le bon tirage, le billet accept\u00e9, le r\u00e9sultat autoris\u00e9 et le r\u00e8glement qui en d\u00e9coule. La difficult\u00e9 consiste \u00e0 d\u00e9finir les heures limites de vente, les fuseaux horaires, les r\u00e9visions des r\u00e9sultats et la reprise apr\u00e8s des messages manquants ou r\u00e9p\u00e9t\u00e9s, et non simplement \u00e0 afficher les num\u00e9ros gagnants.<\/p>\n

Ce guide expose des exigences ind\u00e9pendantes du fournisseur. Il ne d\u00e9crit pas les endpoints r\u00e9els de WhiteLotto et ne promet pas que toutes les interfaces pr\u00e9sent\u00e9es sont incluses. Commencez par le guide d\u2019architecture API de loterie<\/a> et convenez du contrat r\u00e9el avec l\u2019\u00e9quipe de livraison.<\/p>\n

Utiliser des identifiants de tirage stables, pas uniquement des dates<\/h2>\n

Une date ne permet pas d\u2019identifier un tirage de mani\u00e8re fiable si un produit propose plusieurs tirages quotidiens, des reports ou plusieurs fuseaux horaires. Faites correspondre l\u2019identifiant du produit, celui du tirage chez le fournisseur et celui de la plateforme. Conservez ces r\u00e9f\u00e9rences sur les billets et dans les rapports. D\u00e9cidez si un tirage report\u00e9 garde son identit\u00e9 et quel est l\u2019effet d\u2019une annulation sur les billets accept\u00e9s.<\/p>\n

\n
Contrat d\u2019interface des tirages et r\u00e9sultats<\/caption>
Enregistrement<\/th>\u00c0 d\u00e9finir avant l\u2019impl\u00e9mentation<\/th>Preuve d\u2019acceptation<\/th><\/tr><\/thead>
Calendrier des tirages<\/th>Identifiant stable, produit, heure pr\u00e9vue, limite de vente et fuseau horaire applicable.<\/td>Une trace unique entre catalogue, achat et reporting.<\/td><\/tr>\n
Acceptation du billet<\/th>Heure d\u2019acceptation faisant autorit\u00e9, r\u00e8gle de cl\u00f4ture et traitement des r\u00e9ponses incertaines.<\/td>Cas juste avant, \u00e0 la limite et juste apr\u00e8s.<\/td><\/tr>\n
R\u00e9sultat<\/th>Source faisant autorit\u00e9, statut, heure de publication, version et exhaustivit\u00e9.<\/td>Sc\u00e9narios non publi\u00e9s, provisoires et d\u00e9finitifs.<\/td><\/tr>\n
Correction<\/th>R\u00e9f\u00e9rence de r\u00e9vision, motif, approbation et traitement des billets concern\u00e9s.<\/td>Piste d\u2019audit reliant r\u00e9sultat pr\u00e9c\u00e9dent et corrig\u00e9.<\/td><\/tr>\n
R\u00e8glement<\/th>D\u00e9clencheur, responsabilit\u00e9 du calcul, r\u00e9f\u00e9rences d\u2019\u00e9criture et rapprochement.<\/td>Un seul effet financier par r\u00e8glement pr\u00e9vu.<\/td><\/tr>\n<\/tbody><\/table><\/div>\n

Convenir de la s\u00e9mantique temporelle et de la limite de vente<\/h2>\n

Enregistrez un instant sans ambigu\u00eft\u00e9 ainsi que le fuseau horaire local nomm\u00e9 utilis\u00e9 pour l\u2019affichage client et les r\u00e8gles m\u00e9tier. Le format de date et d\u2019heure RFC 3339<\/a> constitue une r\u00e9f\u00e9rence utile pour repr\u00e9senter un instant avec un d\u00e9calage UTC. Ce d\u00e9calage seul ne d\u00e9crit pas les futures r\u00e8gles de changement d\u2019heure d\u2019une r\u00e9gion.<\/p>\n

Pr\u00e9cisez si l\u2019acceptation d\u00e9pend de l\u2019arriv\u00e9e sur la plateforme, de l\u2019acceptation par un fournisseur ou d\u2019un autre \u00e9v\u00e9nement contractuel. Le compte \u00e0 rebours de l\u2019interface est informatif : il ne doit pas d\u00e9cider de l\u2019existence d\u2019un billet. Testez la synchronisation, la d\u00e9rive des horloges, les requ\u00eates retard\u00e9es et les changements d\u2019heure. Affichez un r\u00e9sultat clair lorsque les ventes sont closes.<\/p>\n

Un d\u00e9passement de d\u00e9lai pr\u00e8s de la cl\u00f4ture n\u00e9cessite une recherche du r\u00e9sultat ou un processus d\u2019exception avec responsable. Une nouvelle tentative aveugle peut cr\u00e9er un doublon ou un billet pour un autre tirage. Conservez les r\u00e9f\u00e9rences de l\u2019op\u00e9ration initiale et du tirage demand\u00e9.<\/p>\n

Traiter les corrections de r\u00e9sultat comme des changements contr\u00f4l\u00e9s<\/h2>\n

Distinguez les r\u00e9sultats re\u00e7us, valid\u00e9s, d\u00e9finitifs et corrig\u00e9s dans le mod\u00e8le d\u2019\u00e9tat convenu. Un champ manquant ne doit pas transformer un billet en billet perdant. D\u00e9finissez qui peut autoriser le r\u00e8glement et comment la source est authentifi\u00e9e. En cas de correction, conservez la version pr\u00e9c\u00e9dente et reliez l\u2019ajustement \u00e0 son motif et \u00e0 son approbateur.<\/p>\n

Rejouer une notification ne doit pas r\u00e9gler deux fois le m\u00eame billet. Un ancien r\u00e9sultat re\u00e7u tardivement ne doit pas remplacer une r\u00e9vision autoris\u00e9e plus r\u00e9cente. Les corrections financi\u00e8res doivent rester tra\u00e7ables, et non r\u00e9\u00e9crire silencieusement l\u2019historique comptable initial. Le guide d\u2019int\u00e9gration des paiements<\/a> pr\u00e9sente la discipline correspondante pour les \u00e9v\u00e9nements financiers asynchrones.<\/p>\n

Rendre les \u00e9v\u00e9nements manquants visibles<\/h2>\n