Comment résoudre les erreurs de Pokerai API ?
Utilisez d’abord la réponse HTTP publique et le schéma de l’opération ; les statuts de progression du solveur sont distincts du corps d’erreur partagé.
Error public partagé comporte error et peut inclure message ; les status, spot_status et node_status du solveur sont des champs de réponse distincts.Faits essentiels
| Élément | Contrat public |
|---|---|
| Corps d’erreur | Le schéma partagé Error documente error et message. Ne supposez pas qu’un champ possède un format non publié ni que chaque opération renvoie des champs identiques. |
| Authentification | 401 signifie qu’une clé API est absente ou invalide pour les opérations qui déclarent Unauthorized. |
| Validation | 400 est documenté pour une entrée invalide ou un champ manquant dans les opérations GTO concernées. Vérifiez le schéma de requête actuel de cette opération. |
| Quota et capacité | 429 est documenté pour l’épuisement du quota mensuel dans les opérations concernées ; la planification du solveur peut également renvoyer { "status": "busy" }. |
| Progression du solveur | status, spot_status et node_status décrivent le flux de travail asynchrone du solveur, et non le schéma partagé Error. |
Requête et réponse minimales ayant échoué
curl -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}]}'
HTTP 401
{ "error": "missing_api_key" }Ce format minimal d’échec utilise l’exemple de champ public Error. Ne consignez pas les clés API ni les en-têtes de requête pendant le diagnostic.
Limites d’authentification, de validation et de quota
| HTTP | Signification publique | Vérification suivante |
|---|---|---|
| 400 | Entrée invalide ou champ manquant. | Comparez le corps JSON au schéma de requête actuel de l’opération dans la Référence ou OpenAPI. |
| 401 | Clé API absente ou invalide. | Envoyez un en-tête de clé pris en charge ; consultez Authentification. |
| 404 | Aucune donnée GTO pour une situation ou un board dans les opérations qui déclarent NoSolution. | Vérifiez la situation ou le board envoyé par rapport à la couverture documentée de cette opération. |
| 429 | Quota mensuel dépassé, ou status: busy lorsque tous les hôtes de solveur sont occupés pour la planification du solveur. | Pour le quota, consultez Quotas et le tableau de bord. Pour busy, considérez-le comme un état de capacité et suivez le contrat actuel de l’opération de solveur ; cette page ne garantit aucun délai de nouvelles tentatives. |
| 502 / 503 | 502 correspond à un backend temporairement indisponible dans les opérations concernées. 503 peut signaler upstream_unavailable après les propres nouvelles tentatives du service. | Le contrat OpenAPI indique que le cas amont 503 peut faire l’objet de nouvelles tentatives ; n’en déduisez ni nombre de tentatives, ni délai, ni SLA. |
Le statut du solveur n’est pas un code d’erreur
Après POST /v1/gto/solver, la planification peut renvoyer les valeurs computing, queryable ou busy pour status. Interrogez à répétition POST /v1/gto/solver/tree jusqu’à ce que spot_status soit queryable. Le contrat public de l’arbre définit aussi available, computing, expired et no_nodes ; no_nodes est terminal, cessez donc les interrogations. Les réponses de nœud définissent séparément des valeurs node_status, dont error, avec message présent pour cet état de nœud.
Un nœud expired signifie que la résolution a été récupérée ou remplacée ; le contrat public indique de planifier de nouveau. N’interprétez pas les statuts du solveur comme une promesse concernant le délai d’achèvement, la capacité ou les frais au-delà de la documentation publique actuelle du point de terminaison.
Utilisation sûre et escalade
Utilisez Pokerai API pour l’entraînement, le coaching, la revue de mains, l’étude et la recherche. L’assistance en temps réel (RTA) avec de l’argent réel est interdite. Pour une question non résolue sur le contrat public, conservez le point de terminaison, le statut HTTP et le corps de réponse expurgé, puis utilisez le canal officiel Contact ; n’incluez jamais de clé API.
Documentation associée
- Centre de documentation — flux de travail de l’API et guides thématiques.
- Authentification et Quotas — limites liées aux clés et aux compteurs mensuels.
- Référence de l’API — détails des réponses par opération.
- Instantané OpenAPI — contrat public lisible par machine.
- Journal des modifications — modifications publiées de l’API et de la documentation.
Real-time assistance at real-money tables is prohibited.