アセット
アセットのリストを取得
エンドポイント
GET /v1/spaces/:space_id/assets
リクエスト
cURL
curl "https://api.storyblok.com/v1/spaces/551/assets" -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json"
-H "Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjo3NjgsInRpbWVzdGFtcCI6MTUzODk4MjQ2Mn0.B1wsZtAmy5ICnbJjSvHrlz0PxCy4OO6cHzWVNQOEPNA" \
レスポンス
ボディ
{
"assets": [
]
}
アセット単位で取得
エンドポイント
GET /v1/spaces/:space_id/assets/:id
リクエスト
cURL
curl "https://api.storyblok.com/v1/spaces/550/assets/11" -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json"
-H "Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjo3NjcsInRpbWVzdGFtcCI6MTUzODk4MjQ2Mn0.nEvF0eh3uEC6HNSsDvMsfDCebd5uJiSAyE84DcO9KZA" \
レスポンス
ボディ
{
"id": 11,
"filename": "https://localhost/f/TESTSPACEID/aliquid.eaque.jpg",
"space_id": 550,
"created_at": "2018-10-01T07:07:42.293Z",
"updated_at": "2018-10-01T07:07:42.293Z",
"file": {
"url": null
},
"asset_folder_id": null,
"deleted_at": null,
"short_filename": null
}
アセットに署名
Storyblokへのアセットのアップロード手順は2ステップです。はじめに、アップロードしたいアセットに署名します。その後、私たちのAmazon S3バケットにフォームデータとして画像を投稿します。
ここにnode.jsを使った実例があります。
https://github.com/onefriendaday/storyblok-file-upload-example
エンドポイント
POST /v1/spaces/:space_id/assets
パラメータ
名前 | 説明 |
---|---|
filename(必須) | ファイル名 |
asset_folder_id | アセットフォルダのID |
id | もしアセットのidが提供されていれば、置き換えられる |
リクエスト
cURL
curl "https://api.storyblok.com/v1/spaces/548/assets" -d '{"filename":"test 2%2231.jpg"}' -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json"
-H "Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjo3NjUsInRpbWVzdGFtcCI6MTUzODk4MjQ2Mn0.lE0_Bd24xmebu0cZpk_4_7v_c1RKDJzpILMDxGIkVlI" \
レスポンス
ボディ
{
"pretty_url": "//a.storyblok.com/f/548/3c10e598bd/test-2-2231.jpg",
"public_url": "https://s3.amazonaws.com/a.storyblok.com/f/548/3c10e598bd/test-2-2231.jpg",
"fields": {
"key": "f/548/3c10e598bd/test-2-2231.jpg",
"acl": "public-read",
"Expires": "Tue, 01 Oct 2019 07:07:42 GMT",
"Cache-Control": "public; max-age=31536000",
"Content-Type": "image/jpeg",
"policy": "eyJleHBpcmF0aW9uIjoiMjAxOC0xMC0wMVQwNzoxNzo0MloiLCJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJhLnN0b3J5Ymxvay5jb20ifSx7ImtleSI6ImYvNTQ4LzNjMTBlNTk4YmQvdGVzdC0yLTIyMzEuanBnIn0seyJhY2wiOiJwdWJsaWMtcmVhZCJ9LHsiRXhwaXJlcyI6IlR1ZSwgMDEgT2N0IDIwMTkgMDc6MDc6NDIgR01UIn0seyJDYWNoZS1Db250cm9sIjoicHVibGljOyBtYXgtYWdlPTMxNTM2MDAwIn0seyJDb250ZW50LVR5cGUiOiJpbWFnZS9qcGVnIn0sWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMSw3ODY0MzE5OV0seyJ4LWFtei1jcmVkZW50aWFsIjoiQUtJQUlVNjI3RU5VUVQ0UlcyM0EvMjAxODEwMDEvdXMtZWFzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LHsieC1hbXotYWxnb3JpdGhtIjoiQVdTNC1ITUFDLVNIQTI1NiJ9LHsieC1hbXotZGF0ZSI6IjIwMTgxMDAxVDA3MDc0MloifV19",
"x-amz-credential": "AKIAIU627ENUQT4RW23A/20181001/us-east-1/s3/aws4_request",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-date": "20181001T070742Z",
"x-amz-signature": "6048328baf505bfbfcac66cb0458896daad8e6a0a638f5e71dc0ccee5c5c407c"
},
"post_url": "https://s3.amazonaws.com/a.storyblok.com"
}
アセットの削除
エンドポイント
DELETE /v1/spaces/:space_id/assets/:id
リクエスト
cURL
curl "https://api.storyblok.com/v1/spaces/552/assets/12" -d '' -X DELETE \
-H "Accept: application/json" \
-H "Content-Type: application/json"
-H "Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjo3NjksInRpbWVzdGFtcCI6MTUzODk4MjQ2Mn0.-jrAep0p53tIPolQoaE_pVpTSFTYPCVLx1ynHjr4s9U" \
レスポンス
ボディ
{
"id": 12,
"filename": "https://localhost/f/TESTSPACEID/qui.cupiditate.jpg",
"space_id": 552,
"created_at": "2018-10-01T07:07:42.360Z",
"updated_at": "2018-10-01T07:07:42.360Z",
"file": {
"url": null
},
"asset_folder_id": null,
"deleted_at": "2018-10-01T07:07:42.377Z",
"short_filename": null
}