← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. Pokerai API 오류와 재시도는 어떻게 처리해야 하나요?
가이드 여기서 시작 · 02/06 플랫폼 7 분 중급

Pokerai API 오류와 재시도는 어떻게 처리해야 하나요?

먼저 HTTP 상태와 현재 작업 계약을 확인하세요. 문서화된 400 및 401 응답이 나타내는 문제를 수정하고, 429에서는 할당량 소진과 솔버 용량을 구분하며, 재시도 횟수나 SLA를 가정하지 말고 적용 가능한 일시적 5xx 사례만 재시도하세요.

업데이트됨 관리 주체 Pokerai API

직접 답변: 호출한 작업에는 현재 API 참조 또는 OpenAPI 스냅샷을 사용하세요. 공유 공개 Error 스키마는 error를 문서화하며 message를 포함할 수 있습니다. 공개되지 않은 오류 코드 어휘가 있거나 모든 작업의 응답 필드가 동일하다고 추론하지 마세요.

핵심 정보

오류 형식공개 공통 Error 스키마에는 error가 있으며 message가 포함될 수 있습니다.
400 / 401해당하는 작업에서 400은 잘못된 입력 또는 누락된 필드를 문서화하고, 401은 누락되었거나 유효하지 않은 API 키를 문서화합니다.
429해당 작업에는 월간 할당량 소진이 문서화되어 있으며, 모든 솔버 호스트가 사용 중일 때 솔버 스케줄링은 { "status": "busy" }도 반환할 수 있습니다.
5xx일부 적용 가능한 작업에서는 일시적으로 사용할 수 없는 백엔드(502) 또는 재시도 가능한 upstream_unavailable 응답(503)을 문서화합니다.
할당량공개 할당량 카운터는 월 단위이며, OpenAPI 할당량 응답에 따르면 매월 1일에 재설정됩니다. 현재 계정 상태는 대시보드와 할당량 문서에서 확인하세요.
사용 경계훈련, 코칭, 핸드 리뷰, 학습 및 연구 전용이며, 실제 금전이 걸린 실시간 보조(RTA)는 금지됩니다.

최소 요청 및 민감 정보가 삭제된 오류 응답

이 예시는 의도적으로 자격 증명을 생략합니다. 키나 요청 헤더를 노출하지 않고 공개 인증 경계를 보여 줍니다.

curl -i -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}]}'

OpenAPI Error 예시는 누락된 키에 대해 다음과 같이 민감 정보를 제거한 응답 형식을 지원합니다:

HTTP 401
{ "error": "missing_api_key" }

오류를 진단하는 동안 API 키, Authorization 헤더 또는 마스킹되지 않은 고객 요청 본문을 절대 로그에 기록하지 마세요.

안전한 재시도 및 백오프 원칙

현재 작업 계약에 따라 응답을 분류한 후에만 재시도하세요. 해당하는 일시적 502 또는 재시도 가능한 503의 경우, 애플리케이션이 관리하는 지터가 있는 제한된 지수 백오프를 사용하세요. status: busy가 포함된 솔버 스케줄링 429의 경우, 이를 할당량 소진으로 가정하지 말고 용량 상태로 취급하여 나중에 재시도하세요.

현재 공개 계약을 벗어나는 시도 횟수, 지연, SLA, 멱등성 동작 또는 오류 코드의 의미를 약속하거나 하드코딩하지 마세요. 할당량을 사용할 수 있거나 워크플로 상태를 변경할 수 있는 요청을 다시 제출하기 전에, 이를 반복해도 안전한지 자체 애플리케이션에서 판단하세요.

재시도하지 말아야 할 때

요청을 변경하지 않은 채 해당하는 400 응답을 재시도하지 마세요. 페이로드를 현재 요청 스키마와 비교하고, 잘못되었거나 누락된 입력을 수정하세요. 지원되는 API 키 헤더 또는 키를 수정하기 전에는 해당하는 401을 재시도하지 마세요.

모든 429를 재시도 가능으로 취급하지 마세요. 응답이 문서화된 할당량 소진인 경우에는 대신 대시보드, 요금제, 월간 재설정 시점을 확인하세요. status: busy와 같은 응답 형태는 공통 오류 스키마가 아니라 문서화된 솔버 일정 관리 워크플로에 속합니다.

할당량 및 솔버 상태

Pokerai API는 사전 풀이된 조회와 실시간 풀이를 별도로 측정합니다. 공개 할당량 응답은 매월 1일에 재설정되는 월간 카운터를 설명합니다. 클라이언트에 한도를 하드코딩하지 말고 현재 계정 한도는 대시보드와 요금에서 확인하세요.

솔버 status, spot_status, node_status는 공유 Error 스키마와 별개의 워크플로 필드입니다. 이러한 상태를 완료 시간 또는 요금 보장으로 해석하지 말고, 문서화된 솔버, 트리, 노드 계약을 따르세요.

실제 현금 게임에서의 실시간 보조(RTA) 금지

Pokerai API는 훈련, 코칭, 핸드 리뷰, 학습 및 연구에만 사용하세요. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. 오류 처리 및 재시도 로직을 라이브 테이블 조언을 자동화하는 데 사용해서는 안 됩니다.

문서화된 상태 가이드

이 설명은 작업의 현재 OpenAPI 응답 목록에서 해당 항목을 선언한 경우에만 적용됩니다.

HTTP공개 계약안전한 다음 단계
400잘못된 입력 또는 누락된 필드.요청 스키마 불일치를 수정하세요. 변경 없이 재시도하지 마세요.
401API 키가 없거나 유효하지 않습니다.인증을 수정하세요. 누락되었거나 유효하지 않은 동일한 자격 증명으로 재시도하지 마세요.
429해당 작업에서 월간 할당량이 소진된 경우입니다. 솔버 스케줄링은 대신 status: busy를 보고할 수 있습니다.할당량은 대시보드와 재설정 경계를 확인하세요. 문서화된 busy에는 고정된 재시도 약속 없이 신중한 백오프를 사용하세요.
502 / 503해당 작업은 일시적으로 사용할 수 없는 백엔드 또는 재시도 가능한 upstream_unavailable를 문서화합니다.애플리케이션이 관리하는 지터가 있는 제한된 지수 백오프를 사용하고, 현재 작업 계약을 다시 확인하세요.

SDK, 문서 및 참조