リファレンス

エラーと再試行

HTTP statusだけで原因を決めず、応答のcodeとrequest_idを確認します。問い合わせでは操作・時刻・利用環境・request_idを伝え、資格や原票本文は貼り付けません。

状況別の対応

画像・資産のAPI（v1の資産）は、{error, request_id}の形のJSONで、エラーを返すことがあります。この場合は、errorの値で、分岐します。

認証を直す場合は利用者として接続するまたはserviceとして接続する、競合や結果不明は競合・再送・復帰、解決しない場合の連絡方法はサポートと窓口を参照してください。

401のcode（新しいセッションの方式）

401は、codeで対応を分けます。TOKEN_EXPIREDはアクセストークンの取り直し、SESSION_EXPIRED（無操作の時間を過ぎた）・SESSION_REAUTHENTICATION_REQUIRED（認証から12時間）・SESSION_REVOKED（ログアウトした）はログインのやり直しです。詳しくは、利用者として接続するの「ログインの直後とセッションの期限」にあります。

SESSION_EXPIRED・SESSION_REAUTHENTICATION_REQUIRED・SESSION_REVOKEDは、新しいセッションの方式の稼働版（2026-10以降）で使います。下のコード表（2026-10-07の固定契約から生成）と、固定OpenAPIのcodeの一覧には、まだ載っていません。反映は、次の固定契約の予定です。応答を厳密に検査するクライアントでも、一覧にないcodeを拒否しないでください。

通信が途切れた場合

応答が届かなくても、書込み自体は完了していることがあります。同じ操作の識別子・Idempotency-Key・期待版を保存し、計画の状態や最新のデータで結果を確認します。

OUTCOME_UNKNOWNなど結果未確定の応答は、単純な失敗として別の更新を作る根拠にはなりません。認証切れや権限変更がある場合も、再送時の現在権限で評価されます。

定義されているエラーコード

以下は、公開OpenAPIのコード表から生成しています。コード表には、公開操作に対応しない管理機能のコードも含まれます。FOLDER_LIMIT_REACHEDは管理サイトのDropbox接続で使い、公開OpenAPIの134操作では返りません。画像を含む各機能には、個別の条件もあります。対象の操作の応答と、合わせて確認してください。