エラー
エラー
Box APIでは、HTTPステータスコードを使用して、リクエストが正常に処理されたかどうかを通知します。
クライアントエラー
HTTP 4XX形式の大半のクライアン トエラーとHTTP 5XX形式の一部のサーバーエラーでは、標準のクライアントエラーJSONオブジェクトが返されます。
{
"type": "error",
"status": 400,
"code": "bad_digest",
"help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
"message": "The specified content-md5 did not match what we received",
"request_id": "abcdef123456"
}
詳細については、クライアントエラーのリソースを参照してください。
共通エラーコード
Box APIの使用時に発生した一般的なエラーの解決策については、開発者向けトラブルシューティングの記事を確認してください。
400 Bad Request
エラー | bad_digest | |
メッセージ | The specified content-md5 did not match what we received. (指定のcontent-md5は受信したものと一致しませんでした。) | |
解決策 | ファイルのアップロード中に、ファイルのSHA-1ハッシュとcontent-md5 ヘッダーを指定して、ファイルが転送中に破損していないかどうかを確認できます。リクエストで指定されたSHA-1ハッシュは、アップロードで受信したものと一致していません。アップロードしたファイルの有効なSHA-1ハッシュを指定してください。 | |
エラー | bad_request | |
メッセージ | ||
解決策 | APIリクエストで指定された必須パラメータが見つからないか無効です。詳細については、レスポンス本文の拡張エラーメッセージを確認してください。 | |
エラー | cannot_make_collaborated_subfolder_private | |
メッセージ | Cannot move a collaborated folder to a private folder unless the new owner is explicitly specified. (新しい所有者が明示的に指定されない限り、コラボレーションサブフォルダを非公開フォルダに移動する ことはできません。) | |
解決策 | リクエストのowned_by.id フィールドを設定して、コンテンツの転送先となるユーザーのIDを指定してください。 | |
エラー | collaborations_not_available_on_root_folder | |
メッセージ | Root folder cannot be collaborated (ルートフォルダのコラボレーションができません) | |
解決策 | ユーザーのルートフォルダ (フォルダID 0) にコラボレータを設定できません。ルートフォルダとは異なるフォルダIDを使用してください。 | |
エラー | cyclical_folder_structure | |
メッセージ | Folder move creates cyclical folder structure (フォルダの移動により循環フォルダ構造が作成されます) | |
解決策 | フォルダの移動で指定したフォルダIDによって、循環フォルダ構造 (たとえば、フォルダがそのフォルダ内のサブフォルダに移動される構造) が作成されます。フォルダ移動リクエストで指定するフォルダを変更してください。 | |
エラー | folder_not_empty | |
メッセージ | Cannot delete – folder not empty (削除できません – フォルダにファイルが存在しません) | |
解決策 | 削除する前に、フォルダからすべてのコンテンツを削除してください。 | |