API로 포커 핸드를 어떻게 분석하나요?

홀 카드 핸드와 플롭, 턴 또는 리버 보드를 POST /v1/pokerkit/hand-report로 보내 문서화된 사실 기반 핸드 리포트를 받으세요.

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

직접 답변: 통합 히어로 보고서의 경우 hole과 board를 POST /v1/pokerkit/hand-report에 제출하세요. 보드 전용 작업의 경우 board와 함께 POST /v1/pokerkit/board-report 또는 POST /v1/pokerkit/category-combos를 사용하세요. hole과 board로 POST /v1/pokerkit/hand-tier, POST /v1/pokerkit/draws, POST /v1/pokerkit/outs 또는 POST /v1/pokerkit/blockers를 사용하고, hole_range로 POST /v1/pokerkit/hand-strength를 사용하세요. 보드에서 만들 수 있는 가장 강한 핸드와 동률 콤보에는 POST /v1/pokerkit/nuts를 사용하고, 카드 문자열을 검증하고 정규화하려면 cards와 함께 POST /v1/pokerkit/cards/normalize를 사용하세요. 각 작업의 result를 해석하기 전에 현재 OpenAPI 스키마를 확인하세요. 완료된 핸드는 훈련 또는 검토에만 사용하고, 실제 현금 테이블에서의 액션 선택에는 사용하지 마세요.

핵심 정보

엔드포인트	`POST /v1/pokerkit/hand-report`
필수 입력	공개 `HandRequest` 스키마에 정의된 `hole`(두 장의 카드)과 `board`(3장, 4장 또는 5장의 커뮤니티 카드)
선택 입력	`hand_type` 및 `dead`, 공개 OpenAPI 스키마에 정의된 대로
문서화된 리포트	제출된 핸드와 보드의 텍스처, 메이드 핸드 등급, 드로우, 아웃 및 블로커 맥락
사용 범위	교육, 코칭, 완료된 핸드 검토, 학습 및 연구에만 사용하세요. 실제 현금 실시간 보조(RTA)는 금지됩니다

입력 의미

hole은 플레이어의 홀 카드 두 장이고 board는 세 장, 네 장 또는 다섯 장의 커뮤니티 보드입니다. 구분자 없이 표준 두 글자 카드 코드를 이어 붙이세요. 공개 HandRequest 스키마는 hand_type 및 dead도 허용합니다. 문서화된 워크플로에 필요하지 않으면 생략하세요.

최소 요청 및 응답

이 curl 요청과 응답은 공용 공개 pokerkitHandReport 예시입니다.

curl -s https://pokerai.bet/v1/pokerkit/hand-report \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hole":"JhTh","board":"AsKsQs"}'

{"result":{"texture":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"connectivity":{"name":"HIGH","value":"High"},"rank_band":{"name":"HIGH","value":"High"},"straight_draw":{"name":"OPEN_ENDED","value":"Open-ended"},"flush_draw":{"name":"LIVE","value":"Live"},"are_two_tone":false,"are_monotone":true,"are_rainbow":false},"tier":{"category":{"name":"STRAIGHT","value":"Straight"},"is_nut":false,"nut_rank":{"name":"NON_NUT","value":"Non-nut"}},"draws":{"straight_draw":null,"flush_draw":null,"nut_rank":null},"outs":{"by_category":{},"count":0}}}

보고서 해석 방법

texture는 제공된 보드의 카드, 범주형 웨트니스, 연결성, 랭크 밴드, 가능한 스트레이트 및 플러시 드로우, 수트 형태 불리언을 설명합니다. tier는 메이드 핸드를 분류합니다. 예시에서 category는 스트레이트이고 is_nut은 false입니다. draws는 남은 스트레이트 또는 플러시 드로우 레이블과 그 넛 랭크를 기록합니다. 여기서 null은 예시가 어느 드로우도 보고하지 않음을 뜻합니다. outs는 개선 카드를 범주별로 묶고 count를 제공합니다. 이 예시에는 빈 그룹과 아웃 0개가 있습니다.

공개 문서에서는 Hand Report를 텍스처, 티어, 드로우, 아웃, 블로커를 아우르는 히어로 종합 개요로 설명합니다. 위의 공유된 공개 응답 예시에는 blockers 멤버가 없으므로 클라이언트는 이를 필수로 요구해서는 안 됩니다. 문서화된 블로커 필드를 확인하려면 별도의 POST /v1/pokerkit/blockers 계약을 사용하세요. 이 계약은 넛 콤보 총계와 차단된 수, 블로커 카드, 차단 비율, 히어로가 넛을 차단하는지 여부를 보고합니다.

사용 시점

트레이너, 코칭 도구, 핸드 히스토리 검토, 학습 노트 또는 연구 워크플로에서 완료된 핸드에 주석을 달려면 Hand Report를 사용하세요. UI에서 별도로 문서화된 다른 분석을 표시하기 전에 사실에 근거한 보드 및 핸드 레이블이 필요한 경우 유용합니다.

사용하면 안 되는 경우

설명 필드를 에퀴티, 솔버 결과, 보장 또는 추천 액션으로 취급하지 마세요. 이 엔드포인트를 라이브 테이블 피드에 연결하거나, 출력으로 액션을 자동화하거나, 실제 현금 실시간 보조(RTA)에 사용하지 마세요.

할당량 및 오류

Hand Report는 공개 PokerKit API와 동일한 API 키 및 계정 할당량 시스템을 사용합니다. 한도를 하드코딩하지 말고 현재 계정 한도와 사용량은 할당량 문서, 가격 정보 및 대시보드에서 확인하세요. 공개 OpenAPI 계약에는 422 유효성 검사 응답이 선언되어 있습니다. 현재 API 참조 또는 OpenAPI 스키마에 따라 hole, board 및 선택적 필드를 수정하세요. 인증 및 할당량 오류에는 현재 오류 문서를 사용하고, 변경되지 않은 유효하지 않은 요청은 재시도하지 마세요.

SDK, MCP 및 관련 리소스

개발자 문서는 인증 및 할당량과 함께 공식 SDK 및 MCP 설정을 제공합니다. API 참조에서 현재 작업을, 기계 판독 가능한 OpenAPI 스냅샷에서 확인하세요. 공식 진입점은 Python SDK, TypeScript / JavaScript SDK, 그리고 MCP 서버입니다.

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

Pokerai API는 트레이닝, 코칭, 핸드 리뷰, 학습 및 연구에만 사용됩니다. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. 핸드 분석 결과를 라이브 테이블 자동화에 사용하지 말고, 실시간 액션 지침으로 제시하지 마십시오.

엔드포인트	작업	용도
`POST /v1/pokerkit/hand-report`	핸드 한 개와 보드 분석	문서화된 통합 핸드 보고서를 반환합니다.
`POST /v1/pokerkit/blockers`	블로커 근거 확인	문서화된 넛 콤보 블로커 필드를 별도로 읽습니다.