PokerKit API로 보드 텍스처를 어떻게 분석하나요?
플롭, 턴 또는 리버 보드를 POST /v1/pokerkit/texture로 전송하면 해당 보드에 대해 문서화된 범주형 텍스처 및 수트 형태 필드를 받을 수 있습니다.
AsKsQs와 같이 공용 카드를 board에 구분자 없는 하나의 문자열로 넣어 POST /v1/pokerkit/texture로 전송하세요. 반환된 result는 보드 설명 필드로 해석하세요. 에퀴티, GTO 전략 또는 실시간 액션 추천이 아닙니다.요약 정보
| 엔드포인트 | POST /v1/pokerkit/texture |
|---|---|
| 필수 입력 | board: 3장, 4장 또는 5장의 공용 카드로 이루어진 구분자 없는 문자열(예: AsKsQs) |
| 선택 입력 | 공개 OpenAPI 스키마에 정의된 hand_type 및 dead |
| 응답 | 카드, 범주형 텍스처 필드 및 수트 형태 불리언이 포함된 result 객체 |
| 사용 범위 | 교육, 코칭, 핸드 검토, 학습 및 연구에만 사용 가능하며, 실제 금전 실시간 보조(RTA)는 금지됩니다 |
입력 의미
board는 필수입니다. 표준 두 글자 카드 코드를 구분자 없이 연결하세요. 카드 세 장은 플롭, 네 장은 턴, 다섯 장은 리버를 나타냅니다. 공개 스키마에서는 선택 사항인 hand_type 및 dead도 허용합니다. 문서화된 워크플로에 필요하지 않으면 생략하세요. 이 엔드포인트에는 홀 카드를 보내지 마세요. 플레이어 핸드가 아닌 보드를 설명합니다.
최소 요청
JSON과 API 키를 사용하세요. 이 요청 본문과 아래 응답은 공개 pokerkitTexture 문서 코드 예시입니다.
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'응답 해석
{"result":{"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}}cards는 제공된 보드를 배열로 정규화합니다. wetness, connectivity, rank_band, straight_draw, flush_draw 필드는 name과 표시용 value를 가진 범주형 설명자입니다. 세 불리언은 반환된 보드의 수트 형태를 설명합니다. 이 예에서 are_monotone은 true이고 are_two_tone 및 are_rainbow은 false입니다. 이 레이블은 이 입력을 설명할 뿐, 에퀴티를 계산하거나 포커 액션을 선택하지 않습니다.
사용할 때
교육, 코칭 또는 완료된 핸드 검토 워크플로에서 다른 문서화된 분석을 제시하기 전에 일관된 보드 설명이 필요할 때 텍스처를 사용하세요. 통합 보드 개요가 필요하면 별도의 공개 POST /v1/pokerkit/board-report 계약을 확인하세요. 플레이어별 분석이 필요하면 대신 공개 핸드 리포트, 드로우, 아웃 또는 블로커 계약을 확인하세요.
사용하지 말아야 할 때
텍스처 레이블을 에퀴티 추정치, 솔버 결과, 핸드 강도 보장 또는 추천 액션으로 취급하지 마세요. 텍스처는 문서화된 에퀴티, GTO 또는 플레이어 핸드 엔드포인트 요청을 대체하지 않으며, 실제 금전 라이브 의사 결정 보조에 사용해서는 안 됩니다.
할당량 및 오류
이 엔드포인트는 공개 PokerKit API와 동일한 API 키 및 계정 할당량 시스템을 사용합니다. 클라이언트에 제한을 하드코딩하지 말고, 현재 계정 한도와 사용량은 할당량 문서, 가격 및 대시보드에서 확인하세요.
| 신호 | 의미 | 수행할 작업 |
|---|---|---|
| 422 | 공개 OpenAPI 계약이 유효성 검사 오류 응답을 선언합니다. | 현재 API 참조 또는 OpenAPI 스키마에 따라 board 및 선택 필드를 확인한 후 요청을 수정하세요. |
| 기타 API 오류 | 인증 및 계정 할당량 처리는 API 수준에서 문서화되어 있습니다. | 현재 오류 문서와 대시보드 상태를 사용하세요. 변경되지 않은 잘못된 요청을 재시도하지 마세요. |
SDK, MCP 및 관련 리소스
- 개발자 문서 — 인증 및 할당량과 함께 제공되는 공식 SDK 및 MCP 설정입니다.
- API 참조 — 현재 텍스처 요청 및 응답 계약을 확인하세요.
- OpenAPI 스냅샷 — 기계가 읽을 수 있는 영어 계약입니다.
- Python SDK, TypeScript / JavaScript SDK, MCP 서버 — 공식 패키지 진입점입니다.
- 포커 핸드 검토 API 가이드 — 세션 후 워크플로에 보드 의미를 배치하세요.
- llms.txt — 간결한 LLM 진입점입니다.