문서 주제 · 오류 처리

Pokerai API 오류를 어떻게 해결하나요?

먼저 작업의 공개 HTTP 응답과 스키마를 사용하세요. 솔버 진행 상태는 공통 오류 본문과 별개입니다.

업데이트됨 2026-07-26

직접 답변: HTTP 상태와 엔드포인트의 현재 API 참조 또는 OpenAPI 스냅샷을 확인하세요. 공유 공개 Error 스키마에는 error가 있고 message를 포함할 수 있습니다. 솔버 status, spot_status, node_status는 별도의 응답 필드입니다.

핵심 정보

항목	공개 계약
오류 본문	공유 `Error` 스키마는 `error`와 `message`를 문서화합니다. 어느 필드든 공개되지 않은 형태를 가진다고 가정하거나, 모든 작업이 동일한 필드를 반환한다고 가정하지 마세요.
인증	`401`은 `Unauthorized`를 선언한 작업에서 API 키가 없거나 유효하지 않음을 의미합니다.
유효성 검사	`400`은 해당 GTO 작업에서 잘못된 입력 또는 누락된 필드에 대해 문서화되어 있습니다. 해당 작업의 현재 요청 스키마를 확인하세요.
할당량 및 용량	`429`는 해당 작업에서 월간 할당량 소진에 대해 문서화되어 있으며, 솔버 일정 등록은 `{ "status": "busy" }`를 반환할 수도 있습니다.
솔버 진행 상태	`status`, `spot_status`, `node_status`는 공유 `Error` 스키마가 아니라 비동기 솔버 워크플로를 설명합니다.

최소 실패 요청 및 응답

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Content-Type: application/json" \
  -d '{"hole_cards":"AhKh","positions":{"hero":"UTG"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1}]}'

HTTP 401
{ "error": "missing_api_key" }

이 최소 실패 형태는 공개 Error 필드 예시를 사용합니다. 진단하는 동안 API 키나 요청 헤더를 로그에 남기지 마세요.

인증, 유효성 검사 및 할당량 경계

HTTP	공개 의미	다음 확인 사항
400	잘못된 입력 또는 누락된 필드입니다.	JSON 본문을 해당 작업의 현재 API 참조 또는 OpenAPI 요청 스키마와 비교하세요.
401	API 키가 없거나 유효하지 않습니다.	지원되는 키 헤더 하나를 전송하세요. 인증을 참조하세요.
404	`NoSolution`을 선언한 작업에서 스팟 또는 보드에 대한 GTO 데이터가 없습니다.	제출한 스팟 또는 보드가 해당 작업의 문서화된 적용 범위에 맞는지 확인하세요.
429	월간 할당량이 초과되었거나, 솔버 일정 등록 시 모든 솔버 호스트가 사용 중이면 `status: busy`입니다.	할당량은 할당량 및 대시보드를 참조하세요. `busy`는 용량 상태로 취급하고 현재 솔버 작업 계약을 따르세요. 이 페이지는 재시도 시점에 대해 보장하지 않습니다.
502 / 503	`502`는 해당 작업에서 백엔드를 일시적으로 사용할 수 없음을 의미합니다. `503`은 서비스 자체 재시도 후 `upstream_unavailable`을 보고할 수 있습니다.	OpenAPI 계약은 `503` 업스트림 사례를 재시도 가능으로 표시합니다. 재시도 횟수, 지연 또는 SLA를 추정하지 마세요.

솔버 상태는 오류 코드가 아닙니다

POST /v1/gto/solver 후 일정 등록은 status 값으로 computing, queryable, busy를 반환할 수 있습니다. POST /v1/gto/solver/tree를 spot_status가 queryable이 될 때까지 폴링하세요. 공개 트리 계약은 available, computing, expired, no_nodes도 정의하며, no_nodes는 종료 상태이므로 폴링을 중단하세요. 노드 응답은 node_status 값(error 포함)을 별도로 정의하며, 해당 노드 상태에서는 message가 제공됩니다.

expired 노드는 풀이가 회수되었거나 교체되었음을 의미하며, 공개 계약은 일정을 다시 등록하라고 명시합니다. 솔버 상태를 완료 시간, 용량 또는 엔드포인트의 현재 공개 문서를 넘어서는 요금에 대한 약속으로 해석하지 마세요.

안전한 사용 및 문의

Pokerai API를 교육, 코칭, 핸드 리뷰, 학습 및 연구에 사용하세요. 실제 현금 실시간 보조(RTA)는 금지됩니다. 해결되지 않은 공개 계약 관련 질문이 있으면 엔드포인트, HTTP 상태 및 민감 정보를 제거한 응답 본문을 보관한 후 공식 문의 채널을 이용하세요. API 키는 절대 포함하지 마세요.