Comment effectuer ma première requête avec le SDK JavaScript Pokerai ?

Informations rapides

Installer et s’authentifier

Installez le package officiel, puis n’exposez la clé API qu’au code côté serveur de confiance. Ne validez pas une vraie clé dans le dépôt, ne l’intégrez pas au JavaScript du navigateur et ne l’affichez pas dans les journaux.

npm install @pokerai/client
export POKERAI_API_KEY="gto_your_key_here"

Requête minimale du SDK JavaScript

Ce modèle du SDK officiel appelle l’opération publique de stratégie préflop. La structure de la requête, le point de terminaison et les codes d’état autres que ceux de réussite sont définis par l’instantané OpenAPI actuel.

import { createPokeraiClient } from "@pokerai/client";

const client = createPokeraiClient({
  apiKey: process.env.POKERAI_API_KEY,
});

const { data, error } = await client.POST("/v1/gto/preflop", {
  body: {
    hole_cards: "AhKh",
    positions: { hero: "MP" },
    preflop_actions: [
      { position: "SB", action: "small blind", amount: 0.5 },
      { position: "BB", action: "big blind", amount: 1 },
      { position: "UTG", action: "raise", amount: 3 },
    ],
  },
});

if (error) throw new Error(JSON.stringify(error));
console.log(data.situation, data.strategy);

Interpréter la réponse

En cas de succès, lisez data.situation comme l’état préflop dérivé et parcourez data.strategy. Chaque élément de stratégie possède une action et une frequency de 0 à 1 ; les éléments de mise ou de relance peuvent aussi exposer sizing_pot, amount_bb et allin. Traitez les fréquences comme une distribution mixte pour l’étude ou l’échantillonnage, et non comme une promesse de profit ou un coup recommandé.

La réponse peut inclure data.quota. Enregistrez l’utilisation du compte à partir du résultat renvoyé ou du tableau de bord, plutôt que de l’inférer à partir des compteurs de l’application. Le contrat public actuel — et non une hypothèse codée en dur dans le SDK — reste la source des champs de réponse.

Gestion des erreurs et des quotas

Le contrat public de cette opération déclare 400, 401 et 429. Vérifiez error avant de lire data. Corrigez les entrées invalides au lieu d’effectuer de nouvelles tentatives sans les modifier ; pour des identifiants manquants ou invalides, vérifiez la clé Bearer côté serveur ; pour 429, vérifiez le quota du compte et la documentation actuelle sur les quotas.

Quand l’utiliser

Utilisez ce modèle de client dans un entraîneur côté serveur, un produit de coaching, un outil d’examen de mains terminées, un flux de travail d’étude, un projet de recherche ou une intégration d’agent IA avec contrôle humain. C’est une voie concise lorsque vous souhaitez une interface JavaScript typée OpenAPI tout en validant le contrat d’API public.

Quand ne pas l’utiliser

N’utilisez pas cet exemple dans du code de navigateur qui expose une clé API, un flux de table en direct ou une boucle d’automatisation des actions. Ne déduisez pas la prise en charge de points de terminaison, de méthodes du SDK, de versions, d’une publication dans un registre ou d’affirmations de performances absentes de la source publique et de l’instantané OpenAPI actuels.

Provenance et contrat actuel

Le nom du package, l’entrée d’installation, le dépôt et les liens vers la documentation, la référence et OpenAPI proviennent de locales/product-facts.json. Le nom d’importation et le modèle d’appel client ont été consultés dans la révision source du SDK JavaScript officielle ; ce guide ne revendique délibérément ni version de package ni état de publication dans le registre. Vérifiez la référence de l’API actuelle et l’instantané OpenAPI avant de mettre à jour le code client.

Pas de RTA en argent réel

Pokerai API est destiné uniquement à l’entraînement, au coaching, à l’analyse de mains, à l’étude et à la recherche. L’assistance en temps réel aux tables d’argent réel est interdite. N’intégrez pas la sortie du SDK à l’automatisation de tables en direct et ne présentez pas des fréquences mixtes comme une instruction d’action en temps réel.

Opération publique pertinente

Commencez par la recherche préflop pré-résolue documentée ; utilisez la Référence actuelle et l’instantané OpenAPI avant de sélectionner une autre opération.

Liens vers le SDK, l’API et la provenance

• Documentation pour développeurs — authentification, quotas, SDK, MCP et gestion des erreurs
• Référence de l’API — schéma actuel des requêtes et réponses préflop
• Instantané OpenAPI — contrat public anglais lisible par machine
• Source du SDK JavaScript — dépôt officiel ; examinez sa surface client typée actuelle
• Entrée du package JavaScript — URL du package officiel ; ce guide ne formule aucune affirmation concernant le statut de publication
• SDK Python — point d’entrée officiel du package
• Serveur MCP — point d’entrée officiel du package
• Guide de démarrage rapide de l’API GTO — la requête HTTP minimale équivalente et l’explication de la stratégie mixte
• llms.txt — point d’entrée concis pour LLM