¿Cómo hago mi primera solicitud con el SDK de Pokerai para JavaScript?

Datos rápidos

Instalar y autenticar

Instala el paquete oficial y, después, expón la clave de API solo al código de servidor de confianza. No hagas commit de una clave real, no la incluyas en JavaScript del navegador ni la imprimas en los registros.

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

Solicitud mínima con el SDK de JavaScript

Este patrón oficial del SDK llama a la operación pública de estrategia preflop. La estructura de la solicitud, el endpoint y los códigos de estado no exitosos se definen en la instantánea actual de OpenAPI.

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);

Interpreta la respuesta

Si tiene éxito, lee data.situation como el estado preflop derivado e itera data.strategy. Cada elemento de estrategia tiene una action y una frequency de 0 a 1; los elementos de apuesta o subida también pueden mostrar sizing_pot, amount_bb y allin. Trata las frecuencias como una distribución mixta para estudio o muestreo, no como una promesa de beneficio ni como un único movimiento recomendado.

La respuesta puede incluir data.quota. Registra el uso de la cuenta a partir del resultado devuelto o del panel, en lugar de inferirlo de los contadores de la aplicación. El contrato público actual, no una suposición codificada de forma rígida en el SDK, sigue siendo la fuente de los campos de respuesta.

Gestión de errores y cuota

El contrato público de esta operación declara 400, 401 y 429. Comprueba error antes de leer data. Corrige la entrada no válida en lugar de reintentarlo sin cambios; si faltan credenciales o no son válidas, comprueba la clave Bearer del lado del servidor; para 429, comprueba la cuota de la cuenta y la documentación de cuotas actual.

Cuándo usarlo

Usa este patrón de cliente en un entrenador del lado del servidor, un producto de coaching, una herramienta de revisión de manos completadas, un flujo de estudio, un proyecto de investigación o una integración de agente de IA con revisión humana. Es una vía concisa cuando quieres una superficie de JavaScript tipada con OpenAPI y, al mismo tiempo, validar con el contrato público de la API.

Cuándo no usarlo

No uses este ejemplo en código de navegador que exponga una clave API, una fuente de datos de mesa en vivo o un bucle de automatización de acciones. No infieras compatibilidad con endpoints, métodos del SDK, versiones, publicación en el registro ni afirmaciones de rendimiento que no estén presentes en la fuente pública actual y en la instantánea de OpenAPI.

Procedencia y contrato actual

El nombre del paquete, la entrada de instalación, el repositorio y los enlaces a Documentación, Referencia y OpenAPI proceden de locales/product-facts.json. El nombre de importación y el patrón de llamada del cliente se obtuvieron de la revisión específica del código fuente del SDK de JavaScript oficial; esta guía no afirma deliberadamente una versión del paquete ni el estado de publicación en el registro. Consulta la referencia de la API actual y la instantánea de OpenAPI antes de actualizar el código de cliente.

Sin RTA con dinero real

Pokerai API es solo para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. Mantén la salida del SDK fuera de la automatización de mesas en vivo y no presentes frecuencias mixtas como una instrucción de acción en tiempo real.

Operación pública relevante

Empieza con la consulta preflop prerresuelta documentada; usa la Referencia actual y la instantánea de OpenAPI antes de seleccionar otra operación.

Enlaces del SDK, la API y la procedencia

• Documentación para desarrolladores — autenticación, cuotas, SDK, MCP y gestión de errores
• Referencia de la API — esquema actual de solicitud y respuesta preflop
• Instantánea de OpenAPI — contrato público en inglés legible por máquinas
• Código fuente del SDK de JavaScript — repositorio oficial; consulta la interfaz actual de su cliente tipado
• Entrada del paquete JavaScript — URL oficial del paquete; esta guía no afirma nada sobre el estado de lanzamiento
• SDK de Python — punto de entrada oficial del paquete
• Servidor MCP — punto de entrada oficial del paquete
• Inicio rápido de GTO API — la solicitud HTTP mínima equivalente y la explicación de estrategia mixta
• llms.txt — punto de entrada conciso para LLM