Como faço minha primeira solicitação com o Pokerai JavaScript SDK?

Informações rápidas

Instalar e autenticar

Instale o pacote oficial e, em seguida, exponha a chave de API apenas para código confiável do lado do servidor. Não faça commit de uma chave real, não a inclua no JavaScript do navegador nem a imprima nos logs.

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

Solicitação mínima do SDK JavaScript

Este padrão oficial de SDK chama a operação pública de estratégia pré-flop. O formato da solicitação, o endpoint e os códigos de status de não sucesso são definidos pelo instantâneo atual do 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);

Interpretar a resposta

Em caso de sucesso, leia data.situation como o estado pré-flop derivado e itere por data.strategy. Cada item de estratégia tem uma action e uma frequency de 0 a 1; itens de aposta ou aumento também podem expor sizing_pot, amount_bb e allin. Trate as frequências como uma distribuição mista para estudo ou amostragem, não como uma promessa de lucro ou uma única jogada recomendada.

A resposta pode incluir data.quota. Registre o uso da conta a partir do resultado retornado ou do painel, em vez de inferi-lo a partir de contadores da aplicação. O contrato público atual — e não uma suposição codificada no SDK — continua sendo a fonte dos campos de resposta.

Erros e tratamento de cota

O contrato público desta operação declara 400, 401 e 429. Verifique error antes de ler data. Corrija a entrada inválida em vez de tentar novamente sem alterações; para credenciais ausentes ou inválidas, verifique a chave Bearer no servidor; para 429, verifique a cota da conta e a documentação de cotas atual.

Quando usá-lo

Use este padrão de cliente em um treinador do lado do servidor, produto de coaching, ferramenta de revisão de mãos concluídas, fluxo de estudo, projeto de pesquisa ou integração de agente de IA com revisão humana. É um caminho conciso quando você deseja uma interface JavaScript tipada por OpenAPI e ainda valida em relação ao contrato público da API.

Quando não usá-lo

Não use este exemplo em código de navegador que exponha uma chave de API, um feed de mesa ao vivo ou um loop de automação de ações. Não infira suporte a endpoints, métodos de SDK, versões, publicação no registro ou alegações de desempenho que estejam ausentes da fonte pública atual e do instantâneo do OpenAPI.

Proveniência e contrato atual

Os links para o nome do pacote, entrada de instalação, repositório, Documentação, Referência e OpenAPI vêm de locales/product-facts.json. O nome da importação e o padrão de chamada do cliente foram lidos da revisão do código-fonte do JavaScript SDK oficial; este Guia deliberadamente não afirma uma versão do pacote nem o status de publicação no registro. Confira a Referência da API atual e o instantâneo do OpenAPI antes de atualizar o código do cliente.

Sem RTA com dinheiro real

Pokerai API é destinada apenas a treinamento, coaching, revisão de mãos, estudo e pesquisa. Assistência em tempo real em mesas com dinheiro real é proibida. Mantenha a saída do SDK fora da automação de mesas ao vivo e não apresente frequências mistas como uma instrução de ação em tempo real.

Operação pública relevante

Comece pela consulta preflop pré-resolvida documentada; use a Referência atual e o instantâneo do OpenAPI antes de selecionar outra operação.

Links do SDK, da API e de procedência

• Documentação para desenvolvedores — autenticação, cotas, SDK, MCP e tratamento de erros
• Referência da API — esquema atual de solicitação e resposta pré-flop
• Snapshot do OpenAPI — contrato público em inglês legível por máquina
• Código-fonte do SDK JavaScript — repositório oficial; inspecione sua interface atual de cliente tipada
• Entrada do pacote JavaScript — URL oficial do pacote; este Guia não faz nenhuma afirmação sobre o status de lançamento
• SDK Python — ponto de entrada oficial do pacote
• Servidor MCP — ponto de entrada oficial do pacote
• Início rápido da API GTO — a solicitação HTTP mínima equivalente e a explicação sobre estratégia mista
• llms.txt — ponto de entrada conciso para LLM