APIエラーと再試行を処理する

応答を成功として読み取る前に、常にHTTPステータスを確認してください。ShareAIサービスは異なるエラー形式を返すことがあります：推論は error.code、OAuthは error と error_description、コンソールルートは 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ステータス、エラーコード、時間、および応答/タスク識別子を含めてください。Authorization ヘッダー、クッキー、クライアントシークレット、アクセストークン、リフレッシュトークン、およびプライベートプロンプト内容は削除してください。