ファイルやフォルダ (「項目」) へのAPIコールを作成する際に、404 not found (見つかりません) エラーが返されます。
環境
Box Platform - カスタムアプリケーションを通じたBoxへのAPIコール
根本原因
Boxには、ウォーターフォール設計のコラボレーションに基づくコンテンツアクセス権限モデルがあります。 ユーザーは、招待されたフォルダおよびその下のサブフォルダに対してのみアクセス権を持ちます。 一般には、対象項目へのAPIコールの作成を試みる前に、(ファイルまたはフォルダのコラボレーションを通じて) ユーザーに対象項目へのコラボレーション権限を付与すると適切です。 ユーザーのコラボレーションを一括管理する最も拡張性に優れた方法はグループの使用です。
確認すべきよくある状況:
- 管理者が管理対象ユーザーのコンテンツにアクセスしようとしているが、そのコンテンツへのコラボレーション権限がない。
- サーバー認証用のサービスアカウント、アプリケーションアクセスアプリが管理対象ユーザーのコンテンツにアクセスしようとしている。 管理対象ユーザーはアプリケーションのApp Userではないため、コールが404を返す。 アプリケーションのサービスアカウントまたはApp User以外が所有するコンテンツへの外部呼び出しを作成するには、Enterpriseアクセスが必要である。
- サーバー認証アプリのサービスアカウントがApp Userまたは管理対象ユーザーのコンテンツにアクセスしようとしているが、そのコンテンツへのコラボレーション権限がない。
- App Userまたは管理対象ユーザーが、別のユーザーが所有するコンテンツにアクセスしようとしているが、そのコンテンツへのコラボレーション権限がない。
- Global Content Managerスコープを持つアプリケーションが外部ユーザーが所有する項目への呼び出しを作成しようとしている。GCMスコープはこれを許可しない。
- アプリケーションが「as-user」ヘッダーを使用して、外部で所有されているフォルダにアクセスしようとしている。
解決手順
- 現在のユーザーの情報を取得して、アクセストークンに関連付けられているユーザーIDを確認します。
- 対象項目へのアクセス権限を現在持っているユーザー (またはユーザーのアクセストークン) から、ファイル、親フォルダ、または当該フォルダ構造の上位にある別のフォルダのコラボレータとしてユーザーを追加します。
- 外部で所有されているフォルダ内に項目がある場合は、すでにそのフォルダにコラボレータとして追加されているユーザーにユーザーアクセストークンを使用します。 これにより、外部コンテンツに直接アクセスできるユーザーのコンテキスト内でAPIコールを行えるようになります。