Pokerai API로 포커 카드 문자열을 어떻게 검증하고 정규화하나요?
카드 인식 워크플로에서 사용하기 전에 하나의 간결한 카드 문자열을 공개 PokerKit 정규화 엔드포인트로 전송하세요.
직접 답변: 필수
cards 문자열과 함께 POST /v1/pokerkit/cards/normalize를 호출하세요. 공개 CardsRequest 예시는 AsKsQs입니다. 어떤 응답 필드에 의존하기 전에 최신 API 참조를 확인하세요.핵심 정보
| 항목 | 공개 계약 |
|---|---|
| 작업 | POST /v1/pokerkit/cards/normalize |
| 필수 본문 | cards, 문자열. |
| 공개 예시 | AsKsQs. |
| 카드 표기 | 각 카드는 두 글자입니다. 랭크 AKQJT98765432 뒤에 무늬 c, d, h 또는 s가 오며, 구분자 없이 카드를 이어 붙이세요. |
| 성공 응답 형식 | HTTP 200이 문서화되어 있지만 공개 OpenAPI 스키마는 열려 있습니다. 반환된 JSON 필드는 고정된 필드 수준 계약이 아니라 검사할 응답 데이터로 취급하세요. |
최소 OpenAPI 기반 요청
curl -s https://pokerai.bet/v1/pokerkit/cards/normalize \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cards":"AsKsQs"}'이 요청은 공개 CardsRequest 예시를 사용합니다. 실제로 성공한 호출은 HTTP 200과 함께 JSON을 반환합니다. 현재 공개 스냅샷은 의도적으로 해당 응답 스키마를 열어 두므로 실제 반환 JSON을 검사하고 문서화되지 않은 필드 이름을 하드코딩하지 마세요.
허용되는 입력 및 정규화 범위
As, Kd, Th 같은 간결한 두 글자 카드를 AsKsQs처럼 하나의 문자열로 이어 붙여 사용하세요. 이 엔드포인트는 카드 입력을 검증하고 정규화합니다. 에퀴티를 계산하거나, 핸드를 평가하거나, 액션을 권장하거나, 전략을 추론하지 않습니다.
일반적인 오류 및 개인정보 보호
| 신호 | 공개 계약 | 조치 방법 |
|---|---|---|
HTTP 422 | HTTPValidationError | cards가 존재하고 JSON 문자열인지 확인한 다음, 제출한 표기를 최신 API 참조와 비교하세요. |
| 인증 | 이 작업은 Authorization 및 X-API-Key 요청 헤더를 나열합니다. | 지원되는 API 키 헤더 하나를 전송하세요. 인증을 참조하세요. |
| 개인정보 보호 | 카드는 민감한 게임 또는 사용자 데이터일 수 있습니다. | 필요한 정보만 전송하고, API 키를 요청 본문과 로그에 포함하지 말며, 플레이어 또는 핸드 히스토리를 식별할 수 있는 경우 지원 자료에서 카드 문자열을 가리세요. |
훈련, 코칭, 핸드 리뷰, 학습 및 연구 워크플로에서 정규화를 사용하세요. 이는 실머니 실시간 보조(RTA)가 아니며 전략을 제공하지 않고 라이브 테이블 액션을 안내하는 데 사용해서는 안 됩니다.
관련 문서
- 문서 허브 — PokerKit 및 GTO API 개요.
- 포커 핸드 분석 가이드 — 세션 후 분석 워크플로에서 정규화된 카드 입력을 사용하세요.
- API 참조 — 현재 작업 수준의 요청 및 응답 세부 정보.
- OpenAPI 스냅샷 — 공개
CardsRequest및 응답 계약. - Python SDK, TypeScript / JavaScript SDK, MCP 서버 — 공식 패키지 진입점.
Real-time assistance at real-money tables is prohibited.