リクエスト
Assets APIは、アセットごとの配信用URLにアクセスして利用します。配信用URLは管理画面のメディアライブラリから取得でき、対象プロジェクトを指定するAPIキーを含みます。
配信用URLの取得
配信用URLは、管理画面のメディアライブラリから取得します。各アセットの「…」メニューの「URLをコピー」で、APIキーを含む配信用URLをコピーできます。メディアライブラリの操作は、メディアライブラリのページを参照してください。
エンドポイント
配信用URLのベースURLは次の形式です。{subdomain} にはプロジェクト固有の値が入ります。サブドメインは、KARTE管理画面の[すべてのメニュー]>[Craft]>[CMS設定]>[APIエンドポイント]で確認できます。
https://{subdomain}.assets.cross-cms.comベースURLに続くパスは、メソッドごとに異なります。各メソッドのパスは、メソッドのページを参照してください。
HTTPメソッド
Assets APIのメソッドは、すべてHTTP GETで呼び出します。取得対象は、すべてクエリパラメータで指定します。
APIキーの渡し方
リクエストには、対象プロジェクトのAPIキーをクエリパラメータ apiKey で渡します。メディアライブラリからコピーした配信用URLには、APIキーがすでに含まれています。
リクエストの例
画像を取得する配信用URLの例です。imageId には、取得する画像アセットのIDが入ります。
https://{subdomain}.assets.cross-cms.com/beta/cms/assets/image?apiKey={apiKey}&imageId={imageId}