ファイル (ベース)

ファイルの最も基本的なレプリゼンテーション。fieldsクエリパラメータを使用すると、最小限の数のフィールドが返されます。

このリソースにはAPIの使用時に発生する可能性があるいくつかのバリエーションがあります。

基本バリアントに含まれるフィールドは、fieldsクエリパラメータで指定されたフィールドのほかに、そのパラメータを使用しているときに必ず返されるデフォルトのフィールドを表します。

id string

例12345

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。

type string

例file

次の値に固定: file

etag string

例1

このファイルのHTTP etag。これは変更が発生した場合 (またはしなかった場合) にファイルに対して変更を行う目的でのみ、If-MatchおよびIf-None-Matchヘッダー内の一部のAPIエンドポイントで使用できます。

レスポンスの例

{
  "id": 12345,
  "type": "file",
  "etag": 1
}