← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. API로 PokerKit .phh 핸드 히스토리를 어떻게 파싱하고 재생하나요?
가이드 포커 의미 체계 · 07/09 핸드 리뷰 15 분 고급

API로 PokerKit .phh 핸드 히스토리를 어떻게 파싱하고 재생하나요?

PokerKit .phh 문자열 하나를 구조화된 구성으로 변환하려면 POST /v1/pokerkit/notation/parse를 사용하고, 문서화된 액션 단계를 검토 스냅샷으로 재구성하려면 POST /v1/pokerkit/notation/replay를 사용하세요.

업데이트됨 유지 관리: Pokerai API

직접 답변: POST /v1/pokerkit/notation/parse는 PokerKit .phh 핸드 히스토리 문자열을 포함하는 필수 text 필드를 받습니다. POST /v1/pokerkit/notation/replay는 해당 text 또는 문서화된 구성과 actions를 받으며, 한 단계에 대해서는 선택적으로 index를 받을 수 있습니다. 파싱은 구조화된 핸드 데이터를 추출하고, 리플레이는 표시 및 세션 후 검토를 위한 상태 스냅샷을 반환합니다. 알려진 카드의 세션 후 결과에 대해 POST /v1/pokerkit/eval/hand는 제공된 홀딩과 선택적 보드를 평가하는 반면, POST /v1/pokerkit/eval/compare는 제공된 두 개 이상의 홀딩과 선택적 보드의 순위를 매깁니다. 두 엔드포인트 모두 핸드 히스토리를 평가하거나, 누락된 정보를 재구성하거나, 전략 또는 실시간 플레이 액션을 반환하지 않습니다.

핵심 정보

파싱 엔드포인트POST /v1/pokerkit/notation/parse
리플레이 엔드포인트POST /v1/pokerkit/notation/replay
문서화된 입력파싱에는 text가 필요합니다. 리플레이는 text 또는 actions가 포함된 문서화된 구성 필드를 허용합니다. index는 선택 사항입니다.
문서화된 재생 출력공개 예제는 result.snapshot 및 result.step_count를 반환합니다.
사용 범위교육, 코칭, 핸드 검토, 학습 및 연구 용도로만 사용; 실제 현금 실시간 보조(RTA)는 허용되지 않습니다.

파싱과 리플레이 비교

입력이 PokerKit .phh 텍스트 문자열이고 variant, 블라인드, 시작 스택, actions 같은 문서화된 필드를 포함한 구조화된 구성이 필요할 때 파싱을 사용합니다. 제출한 히스토리의 상태 보기가 필요할 때는 리플레이를 사용합니다. 소스 text 또는 문서화된 구성 필드와 actions를 직접 받을 수 있습니다.

이 엔드포인트들은 역할이 다릅니다. 파싱은 검토 타임라인이나 포커 추천을 생성하지 않습니다. 리플레이는 제공된 히스토리에서 상태를 재구성하며, 핸드를 솔버 전략, 에퀴티 또는 액션 추천으로 변환하지 않습니다.

최소 파싱 요청 및 응답

JSON과 API 키를 사용하세요. 이 요청과 응답은 공개 pokerkitNotationParse 문서 코드 예시입니다.

curl -s https://pokerai.bet/v1/pokerkit/notation/parse \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"variant = \"NT\"\nactions = [\"d dh p1 AhKh\", \"d dh p2 QsQd\"]\n"}'
{"result":{"variant":"NT","actions":["d dh p1 AhKh","d dh p2 QsQd"]}}

전체 공개 문서 코드 예제에는 추가로 파싱된 필드가 포함되어 있습니다. 반환된 구성을 제출된 표기법의 구조화된 표현으로 취급하고, 전체 계약은 현재 API 참조 또는 OpenAPI 스냅샷에서 확인하세요.

표시 또는 검토를 위해 핸드 리플레이

리플레이는 text에서 .phh 문자열을 받거나, 문서화된 구성 필드와 actions를 받을 수 있습니다. 문서화된 특정 단계 인덱스의 스냅샷이 필요한 경우에만 선택적 index를 제공하세요.

curl -s https://pokerai.bet/v1/pokerkit/notation/replay \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variant":"NT","antes":[0,0],"blinds_or_straddles":[1,2],"min_bet":2,"starting_stacks":[200,200],"actions":["d dh p1 AhKh","d dh p2 QsQd","p2 cbr 6","p1 f"],"index":2}'
{"result":{"snapshot":{"terminal":false,"street_index":0,"pot":3,"bets":[2,1],"stacks":[198,199],"board":[],"hole_cards":[{"player":0,"cards":["Ah","Kh"]},{"player":1,"cards":["Qs","Qd"]}]},"step_count":5}}

제출된 히스토리를 렌더링하려면 pot, bets, stacks, board, 합법적 액션 등의 snapshot 필드를 사용하세요. 예시의 step_count는 해당 제출된 액션 목록에 대해 문서화된 횟수입니다.

전체 정보 경계

리플레이는 제출한 내용을 전체 정보로 재구성합니다. 공개 응답 예시에서 snapshot.hole_cards에는 제출된 플레이어의 카드가 포함됩니다. 해당 정보가 제출된 완료 핸드 워크플로에 속하는 경우에만 표시 또는 검토 UI에 적합합니다.

리플레이를 숨겨진 카드 추론, 부분 정보 시뮬레이션, 결과 정확성 보장 또는 실시간 의사결정 도구로 제시하지 마세요. 제공된 표기법 또는 구성과 액션에서 문서화된 상태를 재구성합니다.

사용해야 할 때와 사용하지 말아야 할 때

이 엔드포인트는 세션 후 핸드 히스토리 가져오기, 핸드 검토 타임라인, 코칭 또는 학습용 표시, 혹은 구조화된 PokerKit 표기 기록과 재구성된 상태가 필요한 연구 도구에 사용하세요.

이를 사용해 다른 핸드 히스토리 형식을 지원한다고 주장하거나, 누락된 핸드 정보를 추론하거나, 실제 돈이 걸린 게임에서 실시간 보조(RTA)를 제공하거나, 스냅샷을 베팅 지침으로 바꾸지 마세요. 작업이 GTO 전략, 에퀴티 또는 핸드 평가인 경우, 이는 별도로 문서화된 엔드포인트를 대체하지 않습니다.

오류 및 현재 계약

두 공개 OpenAPI 작업은 모두 422 유효성 검사 오류 응답을 선언합니다. 파싱의 경우, text가 존재하며 PokerKit .phh 표기법에 부합하는지 확인하세요. 리플레이의 경우, 수정하여 다시 제출하기 전에 text 또는 문서화된 구성 필드, actions, 선택적 index를 최신 API 참조 또는 OpenAPI 스키마와 대조하세요.

계정 수준 처리는 최신 인증 문서, 할당량 문서, 오류 문서를 사용하세요. 변경되지 않은 잘못된 요청을 재시도하지 마세요.

실제 돈이 걸린 RTA 금지

Pokerai API는 훈련, 코칭, 핸드 리뷰, 학습 및 연구 용도로만 사용할 수 있습니다. 실제 돈이 걸린 테이블에서의 실시간 보조(RTA)는 금지됩니다. 파싱 및 리플레이 출력을 실시간 테이블 자동화에 사용하지 말고, 스냅샷을 실시간 액션 지침으로 제시하지 마세요.

관련 엔드포인트

추가 형식 또는 분석 지원을 추정하지 말고 각 엔드포인트에 대한 최신 공개 계약을 사용하세요.

엔드포인트기능용도
POST /v1/pokerkit/notation/parsePokerKit .phh 표기법을 포함하는 필수 text를 구조화된 핸드 데이터로 파싱문서화된 PokerKit 핸드 히스토리 가져오기
POST /v1/pokerkit/notation/replay제출된 text 또는 구성과 actions를 스냅샷으로 재구성합니다. 선택 사항인 index로 한 단계를 선택합니다제출된 완료 핸드 표시 또는 검토

SDK, MCP 및 관련 리소스