API 참조

오류

HTTP 상태 코드 및 안전한 재시도 동작

HALO는 가능한 경우 공급자 호환 오류 봉투를 보존하고 인증 및 선택한 결제 흐름에 대해 안정적인 기계 판독 가능 코드를 반환합니다.

#오류 형태

{
  "error": {
    "message": "Invalid API Key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

#상태 코드

상태	의미	기본 작업
400	잘못된 페이로드, 리디렉션, 범위, 모델 또는 계약	자동 402 재시도 래퍼 또는
401	자격증명 또는 필수 증명 누락	인증; 무조건 재시도하지 마세요
403	잘못된 자격 증명 또는 차단됨 리소스	정책 중지 및 검사
402	결제가 필요합니다.	설정 또는 추가 잔액을 확인한 후 다시 시도하세요
409	상태 또는 출시 충돌	상태를 새로고침하고 코드를 따르세요
429	사용 또는 인증 비율 제한	뒤로 돌아가세요
500	예기치 않은 서버 오류	멱등성이 있는 경우에만 재시도
503	필수 종속성 또는 용량을 사용할 수 없음	지터로 뒤로 돌아가세요

#재시도 정책

제한된 백오프를 사용하여 GET 요청 및 명시적으로 멱등성 작업을 재시도합니다.
일회성 인증 코드, 새로 고침 토큰 또는 결제 증명을 맹목적으로 재생하지 마세요.
부분 응답이 이미 클라이언트에 도달했을 수 있으므로 스트리밍 요청에는 애플리케이션 수준 처리가 필요합니다.
Retry-After Retry-After

#보안 실패