← 모든 가이드
이 페이지에서
  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; import createPokeraiClient from @pokerai/client
첫 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 영역을 원할 때 간결한 방법입니다.

사용하지 말아야 하는 경우

API 키, 라이브 테이블 피드 또는 액션 자동화 루프를 노출하는 브라우저 코드에서 이 예제를 사용하지 마세요. 현재 공개 소스 및 OpenAPI 스냅샷에 없는 엔드포인트, SDK 메서드, 버전, 레지스트리 게시 또는 성능 주장에 대한 지원을 추론하지 마세요.

출처 및 현재 계약

패키지 이름, 설치 항목, 저장소, 문서, API 참조 및 OpenAPI 링크는 locales/product-facts.json에서 가져옵니다. 가져오기 이름과 클라이언트 호출 패턴은 공식 JavaScript SDK 소스 리비전에서 확인했습니다. 이 가이드는 패키지 버전이나 레지스트리 게시 상태를 의도적으로 주장하지 않습니다. 클라이언트 코드를 업데이트하기 전에 현재 API 참조 및 OpenAPI 스냅샷을 확인하세요.

실제 현금 게임 실시간 보조(RTA) 금지

Pokerai API는 훈련, 코칭, 핸드 검토, 학습 및 연구에만 사용됩니다. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. SDK 출력을 라이브 테이블 자동화에 사용하지 말고, 혼합 빈도를 실시간 행동 지침으로 제시하지 마세요.

관련 공개 작업

문서화된 사전 풀이된 프리플랍 조회부터 시작하세요. 다른 작업을 선택하기 전에 현재 API 참조 및 OpenAPI 스냅샷을 사용하세요.

엔드포인트SDK 호출사용 용도
POST /v1/gto/preflopclient.POST("/v1/gto/preflop", { body })인증된 사전 풀이된 프리플랍 전략 조회 1회

SDK, API 및 출처 링크