← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. API로 결정론적인 포커 게임 상태 워크플로를 어떻게 구축하나요?
가이드 포커 의미 체계 · 09/09 트레이너 14 분 고급

API로 결정론적인 포커 게임 상태 워크플로를 어떻게 구축하나요?

문서화된 게임 구성과 actions에서 전체 정보 스냅샷을 다시 만들려면 POST /v1/pokerkit/games/state를 사용하고, 확인된 next_action 하나를 추가하려면 POST /v1/pokerkit/games/step를 사용하세요.

업데이트됨 관리 주체 Pokerai API

직접 답변: 애플리케이션에 전체 게임 구성과 액션 목록을 유지하세요. 현재 snapshot 및 legal_actions를 얻으려면 POST /v1/pokerkit/games/state를 호출하세요. 자체 교육 또는 검토 UI를 통해서만 액션을 선택한 다음, 해당 next_action 및 액션 목록 길이와 같은 expected_action_count를 사용하여 POST /v1/pokerkit/games/step를 호출하세요. 반환된 actions를 다음 결정론적 상태로 저장하세요. 변형 코드나 열거형 어휘를 선택하기 전에 GET /v1/pokerkit/meta를 사용하여 현재 문서화된 메타데이터를 읽으세요. 이는 문서화되지 않은 형식을 검증하거나, 라이브 테이블 피드를 노출하거나, 전략을 제공하지 않습니다.

핵심 정보

상태 엔드포인트POST /v1/pokerkit/games/state
단계 엔드포인트POST /v1/pokerkit/games/step
필수 기본 필드두 작업 모두 variant, starting_stacks, antes가 필요합니다. 공개 예시는 variant: NT를 사용합니다.
상태 출력공개 예시는 legal_actions를 포함한 result.snapshot을 반환하고 result.actions를 그대로 되돌려 줍니다.
검증된 추가단계에는 next_action이 필요하며, expected_action_count는 확장할 액션 목록을 위한 낙관적 동시성 토큰입니다.
사용 범위교육, 코칭, 핸드 리뷰, 학습 및 연구를 위한 완전 정보 시뮬레이션으로만 사용하세요. 실제 금전이 걸린 게임에서의 실시간 보조(RTA)는 금지됩니다.

상태와 단계

제공된 구성과 해당 actions로부터 현재 게임 포지션을 재구성해야 할 때 state를 사용하세요. 이 스냅샷은 팟, 스택, 보드, 제출된 홀 카드, legal_actions와 같은 사실 상태를 제공합니다.

동일하게 제공된 액션 목록에 문서화된 하나의 next_action을 추가하는 용도로만 step을 사용하세요. 새 스냅샷과 확장된 actions를 반환합니다. 두 엔드포인트 모두 GTO 전략, 플레이어 모델링 또는 권장 액션을 반환하지 않습니다.

현재 스냅샷 읽기

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

{"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"]}

{"result": {"snapshot": {"terminal": false, "street_index": 0, "actor_index": 0, "pot": 8, "bets": [2, 6], "stacks": [198, 194], "board": [], "hole_cards": [{"player": 0, "cards": ["Ah", "Kh"]}, {"player": 1, "cards": ["Qs", "Qd"]}], "legal_actions": [{"action": "fold"}, {"action": "check_or_call", "amount": 4}, {"action": "complete_bet_or_raise_to", "min": 10, "max": 200}]}, "actions": ["d dh p1 AhKh", "d dh p2 QsQd", "p2 cbr 6"]}}

반환된 스냅샷의 사실 정보만 렌더링하거나 검증하세요. 이 예시에서 legal_actions는 폴드, 체크 또는 콜 금액, 그리고 컴플리트·베팅·레이즈 투의 최솟값과 최댓값을 나열합니다. 이는 제출된 완전 정보 상태의 합법적 액션 영역이며, 어떤 액션을 취할지에 대한 조언이 아닙니다.

동시성 보호를 통해 액션 하나 추가

추가하기 전에 state 호출에 사용한 정확한 액션 목록을 보관하세요. expected_action_count를 그 길이로 설정하고, 의도한 문서화된 next_action을 전송하세요. 공개 스키마는 불일치를 HTTP 409로 설명합니다. 동시 업데이트를 덮어쓰지 말고 저장된 액션 목록을 새로고침한 후 상태를 다시 구축하세요.

{"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"], "next_action": "p1 cc", "expected_action_count": 3}

{"result": {"snapshot": {"terminal": false, "street_index": 1, "actor_index": null, "pot": 12, "bets": [0, 0], "stacks": [194, 194], "board": [], "hole_cards": [{"player": 0, "cards": ["Ah", "Kh"]}, {"player": 1, "cards": ["Qs", "Qd"]}], "legal_actions": [{"action": "deal_board"}]}, "actions": ["d dh p1 AhKh", "d dh p2 QsQd", "p2 cbr 6", "p1 cc"]}}

이 예시는 제출된 세 개의 액션에 p1 cc를 추가하여 네 개의 액션을 반환하고 스냅샷을 진행합니다. 반환된 액션 목록을 다음 state 또는 step 호출의 입력으로 사용해 계속 진행하세요.

결정론적 워크플로와 사람 검토

최소 워크플로는 다음과 같습니다. 구성과 actions를 유지하고, state를 호출하며, 트레이닝 또는 검토 UI에 사실 기반의 snapshot과 legal_actions를 표시합니다. 사람이 문서화된 액션을 선택하거나 승인한 다음, 해당 액션과 예상 개수로 step을 호출하고, 반환된 actions를 유지합니다.

서비스는 실시간 게임 세션을 유지하는 대신 제출된 데이터로부터 상태를 다시 구축합니다. 구성, 액션 목록, 사람의 검토 및 반환된 스냅샷에 대한 자체 감사 기록을 유지하세요. API가 플레이어의 신원을 검증하거나, 상대를 예측하거나, 포커 전략을 선택했다는 인상을 주지 마세요.

완전 정보 및 시뮬레이션 경계

공개 예시에는 제출된 snapshot.hole_cards가 포함됩니다. 스키마에서는 viewer를 예약됨으로, v1을 전체 정보로 설명합니다. 제출되는 모든 카드와 액션이 교육, 시뮬레이션 또는 세션 후 검토 워크플로에 속하는 경우에만 이 엔드포인트를 사용하세요.

이 API를 숨겨진 정보 플레이, 라이브 테이블 피드, 문서화되지 않은 변형 또는 액션 형식 지원, 플레이어 모델링, 전략적 조언으로 표현하지 마세요. 지원 범위를 추론하지 말고 현재 OpenAPI 스키마와 /v1/pokerkit/meta에서 지원되는 변형 코드를 확인하세요.

검증, 현재 계약 및 RTA 금지

두 공개 작업은 422 유효성 검사 응답을 선언합니다. state의 경우 문서화된 구성과 액션 목록을 검증하세요. step의 경우 next_action도 검증하고, 현재 액션을 다시 로드하여 문서화된 409 개수 불일치를 처리하세요. 계정 수준 처리는 현재 인증, 할당량, 오류 문서를 사용하세요.

Pokerai API는 교육, 코칭, 핸드 리뷰, 학습 및 연구용으로만 사용해야 합니다. 실제 금전이 걸린 테이블에서의 실시간 보조(RTA)는 금지됩니다. 스냅샷, 가능한 액션 또는 step 결과를 사용하여 실제 금전이 걸린 의사결정을 자동화하거나 지시하지 마세요.

관련 엔드포인트

상태 재구성과 검증된 액션 추가에는 현재 공개 계약을 사용하세요. 지원되지 않는 게임 형식이나 의사 결정 기능을 추론하지 마세요.

엔드포인트기능사용 용도
POST /v1/pokerkit/games/state제출된 구성과 actions로부터 현재 완전 정보 snapshot 및 legal_actions 재구성결정론적인 트레이닝, 시뮬레이션 또는 세션 후 검토 상태 보기
POST /v1/pokerkit/games/step하나의 next_action을 적용합니다. 선택 사항인 expected_action_count는 액션 목록 확장을 보호합니다제출된 액션 기록에 사람이 검토하고 확인한 추가

SDK, MCP 및 관련 리소스