Comment valider et normaliser des chaînes de cartes de poker avec Pokerai API ?

Envoyez une chaîne compacte de cartes au point de terminaison public de normalisation PokerKit avant de l’utiliser dans un flux de travail tenant compte des cartes.

Mis à jour 28 juillet 2026Maintenu par Pokerai API

Réponse directe : appelez POST /v1/pokerkit/cards/normalize avec la chaîne cards requise. L’exemple public CardsRequest est AsKsQs ; consultez la Référence actuelle avant de vous fier à un quelconque champ de réponse.

Faits rapides

Fait	Contrat public
Opération	`POST /v1/pokerkit/cards/normalize`
Corps requis	`cards`, une chaîne.
Exemple public	`AsKsQs`.
Notation des cartes	Chaque carte comporte deux caractères : le rang `AKQJT98765432` suivi de la couleur `c`, `d`, `h` ou `s` ; concaténez les cartes sans séparateurs.
Format en cas de succès	HTTP `200` est documenté, mais son schéma OpenAPI public est ouvert. Considérez les champs JSON renvoyés comme des données de réponse à examiner, et non comme un contrat fixe au niveau des champs.

Requête minimale étayée par OpenAPI

curl -s https://pokerai.bet/v1/pokerkit/cards/normalize \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cards":"AsKsQs"}'

Cette requête utilise l'exemple public CardsRequest. Un appel réel réussi renvoie du JSON avec HTTP 200 ; comme l'instantané public actuel laisse volontairement ce schéma de réponse ouvert, examinez le JSON réellement renvoyé et ne codez pas en dur des noms de champs non documentés.

Entrée acceptée et périmètre de normalisation

Utilisez des cartes compactes à deux caractères telles que As, Kd et Th, concaténées en une seule chaîne telle que AsKsQs. Ce point de terminaison valide et normalise l'entrée de cartes ; il ne calcule pas l'équité, n'évalue pas une main, ne recommande pas une action et n'infère pas de stratégie.

Erreurs courantes et confidentialité

Indicateur	Contrat public	Que faire
HTTP `422`	`HTTPValidationError`	Vérifiez que `cards` est présent et est une chaîne JSON, puis comparez la notation soumise à la Référence actuelle.
Authentification	L'opération répertorie les en-têtes de requête `Authorization` et `X-API-Key`.	Envoyez un en-tête de clé API pris en charge ; voir Authentification.
Confidentialité	Les cartes peuvent constituer des données de jeu ou d'utilisateur sensibles.	Envoyez uniquement ce qui est nécessaire, gardez les clés API hors des corps de requête et des journaux, et masquez les chaînes de cartes dans le matériel d'assistance lorsqu'elles peuvent identifier un joueur ou un historique de main.

Utilisez la normalisation dans les flux de travail de formation, de coaching, de revue de mains, d'étude et de recherche. Il ne s'agit pas d'une assistance en temps réel pour des jeux d'argent réel (RTA), elle ne fournit pas de stratégie et ne doit pas être utilisée pour guider l'action à une table en direct.

Documentation associée

Centre de documentation — vue d'ensemble de PokerKit et de l'API GTO.
Guide d'analyse de main de poker — utilisez l'entrée de cartes normalisée dans les flux de travail d'analyse après session.
Référence de l'API — détails actuels des requêtes et réponses au niveau de l'opération.
Instantané OpenAPI — le contrat public de CardsRequest et de la réponse.
SDK Python, SDK TypeScript / JavaScript et serveur MCP — points d'entrée des packages officiels.

Real-time assistance at real-money tables is prohibited.