Storyblokのdocs翻訳チャレンジその18！！！

# アセット

## アセットのリストを取得

### エンドポイント

```
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" \
```

### レスポンス

ボディ

```json
{
  "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" \
```

### レスポンス

ボディ

```json
{
  "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" \
```

### レスポンス

ボディ

```json
{
  "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" \
```

### レスポンス

ボディ

```json
{
  "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
}
```