API로 포커 드로우, 아웃, 블로커를 어떻게 가져오나요?

완료된 핸드의 보드와 홀 카드를 공개 PokerKit 작업에 제출하여 사실 기반의 드로우, 아웃, 블로커 라벨을 가져옵니다.

업데이트됨 2026년 7월 27일관리 주체 Pokerai API

직접 답변: hole 및 board를 POST /v1/pokerkit/draws, POST /v1/pokerkit/outs 또는 POST /v1/pokerkit/blockers로 전송하세요. 이들은 별도의 공개 OpenAPI 계약입니다. result를 사용하기 전에 현재 스키마를 읽고, 라벨은 교육, 검토, 학습 또는 연구에만 사용하세요. 실제 현금 액션 선택에는 사용하지 마세요.

빠른 정보

작업	`POST /v1/pokerkit/draws`, `/outs` 및 `/blockers`
필수 입력	`hole` 및 `board`, 공개 `HandRequest` 스키마에서 필수
선택 입력	현재 OpenAPI 스키마에서 허용하는 경우의 `hand_type` 및 `dead`
결과 범위	사실 기반 라벨만 제공하며, 에퀴티, 보장된 결과 또는 권장 액션은 아닙니다
사용 범위	완료된 핸드 훈련, 코칭, 검토, 학습 및 연구 전용; 실제 돈 게임에서의 실시간 보조(RTA) 금지

입력 의미

hole은 히어로의 두 장의 카드이고 board는 세 장, 네 장 또는 다섯 장의 보드입니다. 구분자 없이 표준 두 글자 카드 코드를 사용하세요. 공유 공개 HandRequest 스키마에는 hand_type과 dead도 문서화되어 있습니다. 지원되지 않는 카드 형식이나 필드를 임의로 만들지 마세요.

최소 공개 OpenAPI 요청 및 응답

세 작업은 공개 HandRequest 계약을 공유합니다. 이 최소 요청은 필수 필드만 사용합니다. 다른 좁은 범위의 결과에는 /draws 대신 /outs 또는 /blockers를 사용한 후, 현재 작업별 응답 스키마를 확인하세요.

POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json

{"hole":"JhTh","board":"AsKsQs"}

결과 해석

draws는 문서화된 드로우 라벨로, outs는 문서화된 개선 카드 범주 및 개수로, blockers는 문서화된 넛 콤보 차단 근거로 취급하세요. 개수나 라벨은 확률, 상대 레인지, 에퀴티, 솔버 EV 또는 권장 액션을 나타내지 않습니다. 현재 작업 스키마가 필수로 표시하지 않는 한 필드는 선택 사항으로 유지하세요.

사용 시점

트레이너, 코칭 도구, 핸드 히스토리 검토, 학습 노트 또는 연구 워크플로에서 완료된 핸드에 주석을 추가하려면 이 작업을 사용하세요. 결합된 사실 개요가 좁은 범위의 작업보다 더 유용할 때는 핸드 리포트를 사용하세요.

사용하지 말아야 할 때

이 레이블을 승률 추정, 결과 보장, 실시간 플레이 선택 또는 공개되지 않은 포커 형식 지원에 사용하지 마십시오. 출력을 라이브 테이블 피드나 자동화에 연결하지 마십시오.

할당량 및 오류

이 작업들은 공개 API 키 및 계정 할당량 시스템을 사용합니다. 현재 한도는 할당량 문서, 가격 정보 및 대시보드에서 확인하세요. 한도를 하드코딩하지 마세요. 공개 계약에는 유효성 검사 오류가 명시되어 있습니다. 현재 API 참조를 기준으로 hole, board 및 선택 필드를 수정하세요. 인증 또는 할당량 실패 시 오류 문서를 따르고, 변경되지 않은 유효하지 않은 요청을 재시도하지 마세요.

SDK, MCP 및 관련 리소스

개발자 문서에서는 SDK 및 MCP 설정, 인증, 할당량을 다룹니다. API 참조와 OpenAPI 스냅샷은 현재 공개 계약입니다. 공식 진입점: Python SDK, TypeScript / JavaScript SDK, MCP 서버.

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

Pokerai API는 교육, 코칭, 핸드 리뷰, 학습 및 연구용으로만 사용됩니다. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. 드로우, 아웃 또는 블로커를 실시간 액션 지시로 제시하지 마세요.

엔드포인트	작업	용도
`POST /v1/pokerkit/draws`	드로우 라벨 읽기	제출된 핸드와 보드에 대한 문서화된 드로우 결과를 반환합니다.
`POST /v1/pokerkit/outs`	개선 아웃 읽기	문서화된 아웃 카테고리와 개수를 반환합니다.
`POST /v1/pokerkit/blockers`	블로커 근거 읽기	문서화된 넛 콤보 블로커 필드를 반환합니다.