API 오류 처리 및 재시도

일반적인 의미 error.code, 복구 error 그리고 error_description, 그리고 Console 경로는 반환할 수 있습니다 code, message 그리고 data.status.

상태	일반적인 의미	복구
오류 객체와 함께 200	현재 채팅 엔드포인트에서 장치 가용성이 없는 결과.	error.code를 확인하고 이를 어시스턴트 응답으로 렌더링하지 마십시오.
400	잘못된 요청 또는 OAuth 권한 부여.	본문, 매개변수, 콜백 또는 만료/소모된 코드를 수정하세요.
401	누락되었거나 만료되었거나 유효하지 않은 인증입니다.	자격 증명을 확인하세요; 유효한 OAuth 권한만 새로 고치세요.
402	크레딧 또는 적용 가능한 잔액이 부족합니다.	다시 시도하기 전에 선택한 계정 잔액을 확인하세요.
403	범위, 소유권, 역할 또는 활성 상태 거부.	문서화된 권한 경계를 확인하세요.
404	알 수 없는 리소스 또는 지원되지 않는 게이트웨이 경로.	호스트, 경로 및 리소스 식별자를 확인하세요.
409	상태 또는 수정 충돌.	현재 상태를 읽고 변경 사항을 재고하세요.
429	요청 또는 동시성 제한.	Retry-After를 준수하고 제한된 백오프를 사용하세요.
500 / 502 / 503	서버 또는 업스트림 가용성 실패.	재시도를 제한하고 진단 식별자를 유지하세요.

쓰기를 신중히 처리#

읽기 작업에서 일시적인 실패가 발생하면 지연과 지터를 증가시키며 대기하고, Retry-After가 있을 경우 이를 준수하며 정의된 시도 횟수 또는 시간 예산 후 중지하세요. 데이터를 사용할 수 없을 때 사용자에게 이를 표시하고 무한 루프를 피하세요.

새로 고침 토큰은 단일 사용#

가격 업데이트, 모델 생성 또는 공유 명령의 결과가 불확실할 경우 자동으로 반복하지 마세요. 먼저 리소스 또는 명령 상태를 읽으세요. Idempotency-Key는 지원을 문서화한 엔드포인트에서만 사용하세요, 예를 들어 계약 변경.

지원 요청에 포함할 내용#

새로 고침 회전은 백엔드에서 권한별 잠금이 필요합니다. 소모된 새로 고침 토큰의 맹목적인 재시도는 권한을 취소할 수 있습니다. 참조: 안전한 토큰 새로 고침.

항상 HTTP 상태를 검사하여 응답을 성공으로 읽기 전에 확인하세요. ShareAI 서비스는 다양한 오류 형식을 반환할 수 있습니다: 추론은 제공할 수 있으며, OAuth는 제공하며, 콘솔 경로는 반환할 수 있습니다.#

엔드포인트, HTTP 상태, 오류 코드, 시간 및 응답/작업 식별자를 포함하세요. Authorization 헤더, 쿠키, 클라이언트 비밀, 액세스 토큰, 새로 고침 토큰 및 개인 프롬프트 내용을 제거하세요.