Comment gérer les erreurs et les nouvelles tentatives de la Pokerai API ?
Lisez d’abord le statut HTTP et le contrat actuel de l’opération : corrigez les réponses documentées 400 et 401, distinguez l’épuisement du quota de la capacité du solveur pour 429, et n’effectuez de nouvelles tentatives que pour les cas transitoires 5xx applicables, sans supposer un nombre de nouvelles tentatives ni un SLA.
Error documente error et peut inclure message ; n’en déduisez pas un vocabulaire de codes d’erreur non publié ni des champs de réponse identiques pour chaque opération.Informations clés
| Format d’erreur | Le schéma public partagé Error contient error et peut inclure message. |
|---|---|
| 400 / 401 | Pour les opérations concernées, 400 documente une entrée non valide ou un champ manquant ; 401 documente une clé API manquante ou non valide. |
| 429 | Les opérations applicables documentent l’épuisement du quota mensuel ; la planification du solveur peut également renvoyer { "status": "busy" } lorsque tous les hôtes de solveur sont occupés. |
| 5xx | Certaines opérations applicables documentent un backend temporairement indisponible (502) ou une réponse upstream_unavailable pour laquelle de nouvelles tentatives sont possibles (503). |
| Quota | Les compteurs de quota publics sont mensuels ; la réponse de quota OpenAPI indique qu’ils sont réinitialisés le 1er. Consultez le tableau de bord et la documentation sur les quotas pour connaître l’état actuel du compte. |
| Limite d’utilisation | Uniquement pour l’entraînement, le coaching, la revue de mains, l’étude et la recherche ; aucun RTA avec de l’argent réel. |
Requête minimale et réponse d’erreur expurgée
Ceci omet délibérément les identifiants. Cela illustre la limite d’authentification publique sans exposer de clé ni d’en-tête de requête.
curl -i -s https://pokerai.bet/v1/gto/preflop \
-H "Content-Type: application/json" \
-d '{"hole_cards":"AhKh","positions":{"hero":"UTG"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1}]}'L’exemple OpenAPI Error prend en charge cette forme de réponse expurgée pour une clé manquante :
HTTP 401
{ "error": "missing_api_key" }N’enregistrez jamais les clés API, les en-têtes Authorization ou les corps de requêtes clients non expurgés lors du diagnostic d’une erreur.
Principes de nouvelles tentatives sûres et de temporisation exponentielle
N’effectuez de nouvelles tentatives qu’après avoir classé la réponse selon le contrat actuel de l’opération. Pour un 502 transitoire applicable ou un 503 pour lequel de nouvelles tentatives sont possibles, utilisez une temporisation exponentielle bornée avec gigue, gérée par votre application. Pour la planification du solveur avec 429 et status: busy, traitez-le comme un état de capacité et effectuez de nouvelles tentatives plus tard, plutôt que de supposer qu’il s’agit d’un quota épuisé.
Ne promettez ni n’inscrivez en dur le nombre de tentatives, le délai, le SLA, le comportement d’idempotence ni la signification d’un code d’erreur au-delà du contrat public actuel. Avant de soumettre à nouveau une requête susceptible de consommer le quota ou de modifier l’état du workflow, décidez dans votre propre application s’il est sûr de la répéter.
Quand ne pas effectuer de nouvelles tentatives
N’effectuez pas de nouvelles tentatives à l’identique pour un 400 applicable : comparez la charge utile au schéma de requête actuel et corrigez l’entrée invalide ou manquante. N’effectuez pas de nouvelles tentatives pour un 401 applicable tant que vous n’avez pas corrigé l’en-tête pris en charge pour la clé API ou la clé.
Ne considérez pas chaque 429 comme pouvant faire l'objet de nouvelles tentatives. Lorsque la réponse correspond à l'épuisement de quota documenté, consultez plutôt le tableau de bord, le forfait et la date de réinitialisation mensuelle. Une forme de réponse telle que status: busy relève du flux de planification du solveur documenté, et non du schéma d'erreur partagé.
Quota et statut du solveur
Pokerai API comptabilise séparément les consultations présolues et les résolutions en temps réel. La réponse publique relative au quota décrit un compteur mensuel qui se réinitialise le 1er ; utilisez le tableau de bord et la tarification pour connaître les limites actuelles du compte au lieu d’inscrire une limite en dur dans un client.
Les champs status, spot_status et node_status du solveur sont des champs de flux de travail distincts du schéma Error partagé. Suivez les contrats documentés du solveur, de l’arbre et du nœud au lieu d’interpréter ces états comme une garantie de délai d’achèvement ou de facturation.
Pas de RTA avec de l’argent réel
Utilisez Pokerai API uniquement pour l'entraînement, le coaching, l'analyse de mains, l'étude et la recherche. L'assistance en temps réel aux tables d'argent réel est interdite. La gestion des erreurs et la logique de nouvelles tentatives ne doivent pas être utilisées pour automatiser des conseils aux tables en direct.
Guide des statuts documentés
Ces descriptions ne s’appliquent que lorsque la liste actuelle des réponses OpenAPI de l’opération les déclare.
| HTTP | Contrat public | Prochaine étape sûre |
|---|---|---|
400 | Entrée non valide ou champ manquant. | Corrigez l’incompatibilité avec le schéma de requête ; n’effectuez pas de nouvelles tentatives sans modification. |
401 | Clé API absente ou non valide. | Corrigez l’authentification ; n’effectuez pas de nouvelles tentatives avec le même identifiant manquant ou non valide. |
429 | Épuisement du quota mensuel sur les opérations concernées ; la planification du solveur peut plutôt signaler status: busy. | Pour le quota, consultez le tableau de bord et l’échéance de réinitialisation. Pour busy documenté, utilisez un délai progressif prudent sans promettre un nombre fixe de nouvelles tentatives. |
502 / 503 | Les opérations applicables documentent un backend temporairement indisponible ou upstream_unavailable pour lequel de nouvelles tentatives sont possibles. | Utilisez un délai exponentiel borné avec gigue, géré par l’application ; vérifiez à nouveau le contrat actuel de l’opération. |
SDK, documentation et référence
- Documentation sur la gestion des erreurs — structure publique des erreurs et distinctions entre les statuts du solveur
- Documentation sur les quotas — conseils sur le compteur mensuel du compte
- Référence de l’API — contrats de requête et de réponse propres à l’opération
- instantané OpenAPI — contrat public en anglais lisible par machine
- Guide du SDK Python — configuration officielle du client
- Guide du SDK JavaScript — configuration du client officiel
- Guide MCP — intégration d’agent avec révision humaine