ドキュメント用REST API

レンディション・ページ・カウント取得

get

/documents/api/1.2/files/{fileId}/pages

イメージ・ベースのプレビュー(レンディション)が作成されたイメージを持つ、指定されたファイルに対して作成されたレンディション(ページ)の数を取得します。イメージ・ベースのプレビュー(またはレンディション)は、ファイルの各ページがイメージに変換されるファイル・コンテンツの表示可能な表現です。

リクエスト

サポートされるメディア・タイプ

application/json
application/xml

パス・パラメータ

fileId: string

ファイルのグローバル一意識別子(GUID)。

問合せパラメータ

version(optional): string

使用するファイルのバージョン番号を指定します。バージョンが指定されていない場合は、最新バージョンが使用されます。

ヘッダー・パラメータ

accessToken(optional): string

現在のユーザーに親フォルダまたはこのファイルにアクセスすることを許可するApplinkアクセス・トークン。このパラメータは、appLinkIDが使用されている場合は必須です。これはaccessTokenまたはAccessTokenとして使用できます。
appLinkID(optional): string

現在のユーザーに親フォルダまたはこのファイルにアクセスすることを許可するApplink ID。パラメータappLinkIDが使用されるときはいつでも、パラメータaccessTokenも提供されなければなりません。 appLinkIDまたはAppLinkIDとして使用できます。
dAccessCode(optional): string

保護されたパブリック・リンクを使用するために必要なアクセス・コード。次の形式のCookieヘッダーの一部として送信する必要があります: dAccessCode-<linkID>=<passcodeValue>
linkID(optional): string

現在のユーザーにこのファイルへのアクセスを許可する、パブリック・リンクのパブリック・リンクID。 linkIDまたはLinkIDとして使用できます。

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/octet-stream

200レスポンス

リクエストが処理されました。

ルート・スキーマ: FilePagesResponse

タイプ: object

レスポンス本文には、予約解除操作に関する情報が含まれます。

ソースを表示

errorCode(optional): number

エラー・コードがゼロ(0)の場合は、エラーなしです
id(optional): string

ファイルのグローバル一意識別子(GUID)。
pages(optional): string

イメージ・ベースのプレビュー(レンディション)用に作成されたイメージの数。通常、すべてのページは1つのイメージです。ノート: ファイルにHTML5プレビューのみがある場合、この値はゼロ(0)です。
type(optional): string

アイテム・タイプfile。

{
    "description":"The response body includes information about the unreserve operation.",
    "properties":{
        "id":{
            "type":"string",
            "description":"Globally unique identifier (GUID) for the file."
        },
        "type":{
            "type":"string",
            "description":"Item type <code>file</code>."
        },
        "pages":{
            "type":"string",
            "description":"Number of images created for the image based preview (rendition). Typically every page is one image. Note: if the file only has an HTML5 preview, this value is zero (0)."
        },
        "errorCode":{
            "type":"number",
            "description":"An error code of zero (0) indicates no errors."
        }
    }
}

レスポンスの例(application/json)

{
    "id":"D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages":"22",
    "type":"file",
    "errorCode":"0"
}

403レスポンス

ユーザーに読取り権限がない場合は禁止されています。

404レスポンス

ファイルIDが見つかりません。

トップに戻る

例

次の例では、指定されたファイルのバージョン1にレンディションがあるページ数を返します。

GET .../files/D3C1C1F319CFE6B102095C5DT0000000000100000001/pages?version=1

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "errorCode": "0",
    "id": "D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages": "22",
    "type": "file"
}

例2

次の例では、指定したファイル内の関連付けられたレンディション・イメージがあるページの数が返されます。レンディションはファイルの内容の参照可能な表示です。このファイルは現在のユーザーに所有または共有されていないフォルダ構造にあるため、この例では、パブリック・リンクIDを使用します。

GET .../files/D3C1C1F319CFE6B102095C5DT0000000000100000001/pages?version=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "errorCode": "0",
    "id": "D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages": "1",
    "type": "file"
}

例3

次の例では、指定したファイル内の関連付けられたレンディション・イメージがあるページの数が返されます。レンディションはファイルの内容の参照可能な表示です。このファイルは現在のユーザーに所有または共有されていないフォルダ構造にあるため、この例では、アクセス・コードで保護されているパブリック・リンクIDを使用します。アクセス・コード( test12345)は、Cookieの一部としてリクエスト・ヘッダーに発行されます。

GET .../files/D3C1C1F319CFE6B102095C5DT0000000000100000001/pages?version=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518
Cookie: dAccessCode-LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518=test12345

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "errorCode": "0",
    "id": "D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages": "1",
    "type": "file"
}

例4

次の例では、指定したファイル内の関連付けられたレンディション・イメージがあるページの数をリクエストします。このファイルは現在のユーザーに所有または共有されていないフォルダ構造にあるため、アクセス拒否エラー・メッセージが返されます。

GET .../files/D3C1C1F319CFE6B102095C5DT0000000000100000001/pages?version=1

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 403

JSONレスポンス

{
    "errorCode": "-20",
    "errorKey": "!csCloudItemInsufficientPrivileges,User BB,fFileGUID:D3C1C1F319CFE6B102095C5DT0000000000100000001,GET_CLOUD_EXPORT_STATUS",
    "errorMessage": "User 'User BB' has insufficient privilege to access fFileGUID:D3C1C1F319CFE6B102095C5DT0000000000100000001 with service GET_CLOUD_EXPORT_STATUS.",
    "errorType": "file",
    "id": "D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages": "0",
    "title": "User 'User BB' has insufficient privilege to access fFileGUID:D3C1C1F319CFE6B102095C5DT0000000000100000001 with service GET_CLOUD_EXPORT_STATUS.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "version": "1"
}

例5

次の例では、指定したファイル内の関連付けられたレンディション・イメージがあるページの数をリクエストします。このファイルは現在のユーザーに所有または共有されていないフォルダ構造にあります。また、アクセス・コードで保護されているパブリック・リンクのみを使用可能です。アクセス・コードがリクエストの一部として送信されなかったため、エラーが返されます。

GET .../files/D3C1C1F319CFE6B102095C5DT0000000000100000001/pages?version=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 403

JSONレスポンス

{
    "errorCode": "-18",
    "errorKey": "!csAccessCodeRequiredForLinkAccess",
    "errorMessage": "The access code must be provided to access the link.",
    "errorType": "file",
    "id": "D3C1C1F319CFE6B102095C5DT0000000000100000001",
    "pages": "0",
    "title": "The access code must be provided to access the link.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "version": "1"
}

例6

次の例では、指定したファイル内の関連付けられたレンディション・イメージがあるページの数が返されます。レンディションはファイルの内容の参照可能な表示です。このファイルは現在のユーザーが所有していない、または共有していないフォルダ構造の下にあるため、この例ではapplink IDを使用しています。 applink IDとアクセス・トークンはリクエスト・ヘッダーに送信されます。

GET .../files/DED694950C14AFF280419F9AB5D17B95F47087F4E518/pages?version=1

リクエスト・ヘッダー

appLinkID: LF5Bxj4TPo_p4n4qWn0tbKTicR2cTUJKv7X_ng9E7ry93rRuDokPqS1d6-wKwhb_wtcGYFDsI_cNMxeKQ-HR-FXQhiVoGRTYM_MPZY8qpICfYU94mmnMjM_cvsRhKMzc0NJgvwEJfqqDwPsAVrhc8cmg==
accessToken: 352FpiMmW66PeYI1Gh5b83I9CXRwZhLfYAu4TXdqpzD8uNKUBMZVVJ3ZvivUW8kQ

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

JSON Response
{
    "errorCode": "0",
    "id": "DED694950C14AFF280419F9AB5D17B95F47087F4E518",
    "pages": "1",
    "type": "file",
    "version": "1"
}

先頭に戻る