ファイル (Mini) - Box Dev Docs

APIバージョン 2024.0 他のリソースの下にネストされたときに使用されるファイルのMini版の表示。

このリソースにはAPIの使用時に発生する可能性があるいくつかのバリエーションがあります。通常、Miniバリアントに含まれるフィールドは、このリソースが別のリソースのレスポンス内にネストされている場合に返されます。

string

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

type

string

例 file値は常にfileになります。次の値に固定: file

etag

string

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

file_version

ファイルバージョン (Mini)object

ファイルの現在のバージョンに関する情報。

name

string

例 Contract.pdfファイルの名前。

sequence_id

string

例 3この項目に適用された最新のUser Eventを表す数値の識別子。これをGET /eventsエンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventのsequence_idが最初に取得されたリソースのsequence_idよりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。

sha1

string(digest)

例 85136C79CBF9FE36BB9D05D0639C70C265C18D37ファイルのSHA1ハッシュ。Box上のファイルとローカルファイルの内容を比較する目的に使用できます。

{
  "id": "12345",
  "type": "file",
  "etag": "1",
  "file_version": {
    "id": "12345",
    "type": "file_version",
    "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
  },
  "name": "Contract.pdf",
  "sequence_id": "3",
  "sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37"
}