公開されたレンディションを取得
get
/content/published/api/v1.1/assets/{id}/{rendition}
公開されたデジタル・アセットの特定のレンディションをレンダリングします。 レスポンスで受信されたコンテンツ・タイプ・ヘッダーは、メディア・タイプ情報を有します。
リクエスト・ヘッダー(オプション):
リクエスト・ヘッダー(オプション):
| ヘッダー名 | ヘッダー値 |
|---|---|
| channelToken | {有効なチャネル・トークン値} |
リクエスト
パス・パラメータ
- id: string
アイテムの一意の識別子(ID)。
- rendition: string
デジタル・アセットの表示名。
問合せパラメータ
- channelToken(optional): string
channelToken
- download(optional): boolean
デフォルトでは、イメージ・タイプのファイルに対しては、オーディオおよびビデオがインラインでレンダリングされます。 その他のすべてのファイル・タイプについては、ダウンロードされます。 このデフォルトをオーバーライドするリクエストに、問合せパラメータdownload=true/falseを指定できます。
- format(optional): string
デジタル・アセット・ファイルのメディア・タイプの拡張。 レンディションにフォーマットが1つしかない場合、フォーマット問合せパラメータは省略できます。
- type(optional): string
デジタル・アセットのレンディション・タイプ。
- version(optional): string
デジタル・アセットのバージョン。
レスポンス
サポートされているメディア・タイプ
- application/octet-stream
- application/json
200レスポンス
操作の成功
304レスポンス
変更されません。 リクエストは電子タグでリクエストを受け付けます。
400レスポンス
不正リクエスト。 サーバーは、不正な構文、無効なデータまたはメッセージ・フレーミングのために、クライアント側でリクエストを処理できません。
403レスポンス
禁止。 クライアントはこのリクエストを実行する権限がありません。
404レスポンス
リクエストされたリソースは見つかりませんでした。
500レスポンス
内部サーバー・エラー システムで予期しないエラーが発生しました。
例
次の例は、パブリッシュされたデジタル・アセット・レンディション・ファイルを取得する方法を示しています。
curl -i -X GET -H "Accept:application/json" 'http://<hostname>/content/published/api/v1.1/assets/{id}/{rendition}'
例
IDを持つ公開済DigitalAssetサムネイル・レンディションを取得: CONT826832D8B7BC4BDBA372586ECFCB47DD, channelTokenを使用: b361a487716547d8a7527021a2d6628c
/content/published/api/v1.1/assets/CONT826832D8B7BC4BDBA372586ECFCB47DD/Thumbnail?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c
レスポンス本文
DigitalAsset Thumbnail renditions file will be displayed.