← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. Pokerai JavaScript SDK で最初のリクエストを行うには？
クイックスタート ここから始める · 04/06 JavaScript 10 分 初心者

Pokerai JavaScript SDK で最初のリクエストを行うには？

@pokerai/clientをインストールし、APIキーでcreatePokeraiClientを作成してから、/v1/gto/preflop用に型付けされたPOSTメソッドを呼び出します。

更新日 管理元 Pokerai API

直接の回答: npm install @pokerai/client を使用し、POKERAI_API_KEY はサーバー側の環境変数に保持して、createPokeraiClient({ apiKey }) を作成し、client.POST("/v1/gto/preflop", { body }) を呼び出します。結果では、パース済みの data と型付けされた error が分けられます。これはライブプレイ向けの推奨ではありません。

要点

公式パッケージのエントリnpm install @pokerai/client; @pokerai/clientからcreatePokeraiClientをインポート
最初のSDK呼び出しclient.POST("/v1/gto/preflop", { body }) は、文書化された事前解析済みのプリフロップ操作を呼び出します
認証createPokeraiClient({ apiKey }) はキーをBearerトークンとして送信します。キーはダッシュボードへのサインインから作成してください
レスポンスクライアントは成功時にパース済みの data を、失敗時には型付けされた error を返します。ドキュメント化された成功時フィールドには situation、strategy、quota が含まれます。
無料ティア月あたり事前解析済みルックアップ 1,000 回 + リアルタイム解析 25 回。このリクエストでは事前解析済みルックアップのクォータを1回分消費します
利用上の制限トレーニング、コーチング、ハンドレビュー、学習、研究目的に限定。リアルマネーでのリアルタイム支援 (RTA) は不可

インストールと認証

公式パッケージをインストールし、API キーは信頼できるサーバーサイドコードにのみ公開してください。実際のキーをコミットしたり、ブラウザ JavaScript にバンドルしたり、ログに出力したりしないでください。

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

最小限のJavaScript SDKリクエスト

この公式SDKパターンは、公開プリフロップ戦略操作を呼び出します。リクエスト形式、エンドポイント、成功以外のステータスコードは、現在の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);

レスポンスを解釈する

成功時は、導出されたプリフロップ状態として data.situation を読み取り、data.strategy を反復処理します。各戦略項目には action と 0 から 1 までの frequency があり、ベットまたはレイズの項目では sizing_pot、amount_bb、allin も提供される場合があります。頻度は、利益の保証や単一の推奨アクションとしてではなく、学習やサンプリングのための混合分布として扱ってください。

レスポンスにはdata.quotaが含まれる場合があります。アプリケーションのカウンターから推測するのではなく、返された結果またはダッシュボードでアカウント利用状況を記録してください。レスポンスフィールドの基準は、SDKにハードコードされた想定ではなく、現在公開されている契約です。

エラーとクォータの処理

この操作の公開契約では 400、401、429 が定義されています。data を読み取る前に error を確認してください。無効な入力は変更せずに再試行するのではなく修正してください。認証情報が不足しているか無効な場合は、サーバー側のBearerキーを確認してください。429 の場合は、アカウントのクォータと現在の クォータに関するドキュメント を確認してください。

使用するタイミング

このクライアントパターンは、サーバーサイドのトレーナー、コーチング製品、完了済みハンドのレビューツール、学習ワークフロー、研究プロジェクト、または人によるレビューを伴う AI エージェント統合で使用してください。公開 API 契約に対する検証を継続しながら、OpenAPI 型付きの JavaScript インターフェースを利用したい場合に簡潔な選択肢です。

使用すべきでない場合

APIキー、ライブテーブルのフィード、またはアクション自動化ループを露出するブラウザコードで、この例を使用しないでください。現在の公開ソースおよびOpenAPIスナップショットに記載のないエンドポイント、SDKメソッド、バージョン、レジストリでの公開状態、またはパフォーマンスに関する主張がサポートされていると推測しないでください。

出所と現在の契約

パッケージ名、インストールエントリ、リポジトリ、ドキュメント、リファレンス、および OpenAPI リンクは locales/product-facts.json に由来します。インポート名とクライアント呼び出しパターンは、公式の JavaScript SDK ソースリビジョン から確認しました。このガイドでは、パッケージバージョンやレジストリでの公開状態を意図的に主張していません。クライアントコードを更新する前に、最新の API リファレンス と OpenAPIスナップショットを確認してください。

リアルマネーでのリアルタイム支援 (RTA) は禁止

Pokerai APIは、トレーニング、コーチング、ハンドレビュー、学習、研究のみを目的としています。リアルマネーテーブルでのリアルタイム支援は禁じられています。SDKの出力をライブテーブルの自動化に使用せず、ミックス頻度をリアルタイムのアクション指示として提示しないでください。

関連する公開操作

ドキュメント化された事前解析済みプリフロップ検索から始めてください。別の操作を選択する前に、最新のAPI リファレンスとOpenAPIスナップショットを参照してください。

エンドポイントSDK 呼び出し用途
POST /v1/gto/preflopclient.POST("/v1/gto/preflop", { body })認証を伴う事前解析済みプリフロップ戦略ルックアップ 1 回

SDK、API、および出所に関するリンク