機械翻訳について

移動

• リクエスト
• レスポンス
• 例

ファイル名を使用してデジタル・アセットの特定のレンディションをスラグでプレビュー

get

/content/preview/api/v1.1/assets/.by.slug/{slug}/{rendition}/{filename}

スラグとファイル名の両方を使用して、デジタル・アセットの最新バージョンのレンディションを取得します。 レスポンスで受信されたコンテンツ・タイプ・ヘッダーは、メディア・タイプ情報を有します。

リクエスト・ヘッダー(オプション):

ヘッダー名	ヘッダー値
channelToken	{有効なチャネル・トークン値}

リクエスト

パス・パラメータ

• filename: string
  デジタル・アイテムの名前。名前に使用する特殊文字はエンコードする必要があります
• rendition: string
  デジタル・アセットの表示名。
• slug: string
  プレビューするアイテムのスラグ値。

問合せパラメータ

• channelToken(optional): string
  ターゲット・チャネルのチャネル・トークン。 チャネル・トークンは、問合せパラメータまたはリクエスト・ヘッダーのいずれかとして提供する必要があります。
• download(optional): boolean
  デフォルトでは、イメージ、オーディオ、ビデオなどのメディア・タイプは、コンテンツ処理ヘッダーのインラインに設定されています。 他のすべてのメディア・タイプでは、コンテンツの配置はダウンロードするように設定されています。 ユーザーは、デフォルト値を上書きするリクエストで、問合せパラメータdownloadをtrue/falseとして指定できます。
• format(optional): string
  デジタル・アセット・ファイルのメディア・タイプの拡張。 レンディションにフォーマットが1つしかない場合、フォーマット問合せパラメータは省略できます。
• type(optional): string
  デジタル・アセットのレンディション・タイプ。

トップに戻る

レスポンス

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

• application/octet-stream
• application/json

200レスポンス

操作の成功

304レスポンス

変更されません。 リクエストは電子タグでリクエストを受け付けます。

400レスポンス

不正リクエスト。 サーバーは、不正な構文、無効なデータまたはメッセージ・フレーミングのために、クライアント側でリクエストを処理できません。

403レスポンス

禁止。 クライアントはこのリクエストを実行する権限がありません。

404レスポンス

リクエストされたリソースは見つかりませんでした。

500レスポンス

内部サーバー・エラー システムで予期しないエラーが発生しました。

トップに戻る

例

例:

次の例は、cURLを使用してRESTリソースに対するGETリクエストを送信することで、ファイル名を指定してデジタル・アセット・レンディション・ファイルをプレビューする方法を示しています:

curl -X GET -H 'Accept: application/json' 'https://host:port/content/preview/api/v1.1/assets/.by.slug/image-1489851752573-sport/Thumbnail/sport.jpg?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c' 

スラグ付きのDigitalAssetサムネイル・レンディションの最新バージョンを取得 : image-1489851752573-sport (channelToken:b361a487716547d8a7527021a2d6628cとファイル名) : sport.jpg。

レスポンス本文

デジタル・アセットのネイティブ・ファイルが表示されます。

トップに戻る