> For the complete documentation index, see [llms.txt](https://docs.annict.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.annict.com/docs/ja/api/v1/me-reviews.md).

# me-reviews

## POST /v1/me/reviews

作品へのレビューが投稿できます。

**このリクエストには `write` スコープが必要になります。**

### パラメータ

| 名前                       | 概要                                                                                  | データ例                 |
| ------------------------ | ----------------------------------------------------------------------------------- | -------------------- |
| work\_id                 | **\[必須]** 作品ID                                                                      | 3994                 |
| title                    | **\[非推奨]** タイトル。現在このプロパティに入力された文字列は感想にマージされます。                                      | あぁ^～心がぴょんぴょんするんじゃぁ^～ |
| body                     | **\[必須]** 感想                                                                        | 僕は、リゼちゃん！◯（ ´∀｀ ）◯   |
| rating\_animation\_state | レーティング (映像)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| rating\_music\_state     | レーティング (音楽)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| rating\_story\_state     | レーティング (ストーリー)。`bad` `average` `good` `great` が入力できます。                              | great                |
| rating\_character\_state | レーティング (キャラクター)。`bad` `average` `good` `great` が入力できます。                             | great                |
| rating\_overall\_state   | レーティング (全体)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| share\_twitter           | 記録をTwitterにシェアするかどうか。`true` または `false` が入力できます。指定しなかったときは `false` (シェアしない) になります。  | true                 |
| share\_facebook          | 記録をFacebookにシェアするかどうか。`true` または `false` が入力できます。指定しなかったときは `false` (シェアしない) になります。 | true                 |

### リクエスト例

```
$ curl -X POST "https://api.annict.com/v1/me/reviews?work_id=3994&title=あぁ^～心がぴょんぴょんするんじゃぁ^～&body=みんなかわいい&rating_animation_state=good&rating_music_state=good&rating_story_state=good&rating_character_state=great&rating_overall_state=great&access_token=(access_token)"
```

```javascript
{
    "id": 595,
    "title": "",
    "body": "あぁ^～心がぴょんぴょんするんじゃぁ^～\n\nみんなかわいい",
    "rating_animation_state": "good",
    "rating_music_state": "good",
    "rating_story_state": "good",
    "rating_character_state": "great",
    "rating_overall_state": "great",
    "likes_count": 0,
    "impressions_count": 0,
    "modified_at": null,
    "created_at": "2017-06-24T18:59:57.192Z",
    "user": {
        "id": 2,
        "username": "shimbaco",
        "name": "Koji Shimba",
        "description": "",
        "url": null,
        "avatar_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_avatars/master/d8af7adc8122c96ba7639218fd8b5ede332d42f2.jpg?1431357292",
        "background_image_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_background_images/master/ee15d577fb2f2d61bdaf700cfab894b286a5762d.jpg?1486753229",
        "records_count": 123,
        "created_at": "2016-05-03T19:06:59.929Z"
    },
    "work": {
        "id": 3994,
        "title": "ご注文はうさぎですか？",
        "title_kana": "ごちゅうもんはうさぎですか",
        "media": "tv",
        "media_text": "TV",
        "released_on": "2014-04-10",
        "released_on_about": "",
        "official_site_url": "http://www.gochiusa.com/",
        "wikipedia_url": "http://ja.wikipedia.org/wiki/%E3%81%94%E6%B3%A8%E6%96%87%E3%81%AF%E3%81%86%E3%81%95%E3%81%8E%E3%81%A7%E3%81%99%E3%81%8B%3F#.E3.83.86.E3.83.AC.E3.83.93.E3.82.A2.E3.83.8B.E3.83.A1",
        "twitter_username": "usagi_anime",
        "twitter_hashtag": "gochiusa",
        "images": {
            "recommended_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
            "facebook": {
                "og_image_url": ""
            },
            "twitter": {
                "mini_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=mini",
                "normal_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=normal",
                "bigger_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
                "original_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=original",
                "image_url": ""
            }
        },
        "episodes_count": 12,
        "watchers_count": 1463,
        "season_name": "2014-spring",
        "season_name_text": "2014年春"
    }
}
```

## PATCH /v1/me/reviews/:id

作成したレビューを編集することができます。

**このリクエストには `write` スコープが必要になります。**

### パラメータ

| 名前                       | 概要                                                                                  | データ例                 |
| ------------------------ | ----------------------------------------------------------------------------------- | -------------------- |
| id                       | **\[必須]** 記録ID                                                                      | 1016                 |
| title                    | **\[非推奨]** タイトル。現在このプロパティに入力された文字列は感想にマージされます。                                      | あぁ^～心がぴょんぴょんするんじゃぁ^～ |
| body                     | **\[必須]** 感想                                                                        | 僕は、リゼちゃん！◯（ ´∀｀ ）◯   |
| rating\_animation\_state | レーティング (映像)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| rating\_music\_state     | レーティング (音楽)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| rating\_story\_state     | レーティング (ストーリー)。`bad` `average` `good` `great` が入力できます。                              | great                |
| rating\_character\_state | レーティング (キャラクター)。`bad` `average` `good` `great` が入力できます。                             | great                |
| rating\_overall\_state   | レーティング (全体)。`bad` `average` `good` `great` が入力できます。                                 | great                |
| share\_twitter           | 記録をTwitterにシェアするかどうか。`true` または `false` が入力できます。指定しなかったときは `false` (シェアしない) になります。  | true                 |
| share\_facebook          | 記録をFacebookにシェアするかどうか。`true` または `false` が入力できます。指定しなかったときは `false` (シェアしない) になります。 | true                 |

### リクエスト例

```
$ curl -X PATCH "https://api.annict.com/v1/me/reviews/595?body=みんなかわいい！！&rating_animation_state=good&rating_music_state=good&rating_story_state=good&rating_character_state=great&rating_overall_state=great&access_token=(access_token)"
```

```javascript
{
    "id": 595,
    "title": "あぁ^～心がぴょんぴょんするんじゃぁ^～",
    "body": "みんなかわいい！！",
    "rating_animation_state": "good",
    "rating_music_state": "good",
    "rating_story_state": "good",
    "rating_character_state": "great",
    "rating_overall_state": "great",
    "likes_count": 0,
    "impressions_count": 1,
    "modified_at": "2017-06-24T19:07:46.257Z",
    "created_at": "2017-06-24T18:59:57.192Z",
    "user": {
        "id": 2,
        "username": "shimbaco",
        "name": "Koji Shimba",
        "description": "",
        "url": null,
        "avatar_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_avatars/master/d8af7adc8122c96ba7639218fd8b5ede332d42f2.jpg?1431357292",
        "background_image_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_background_images/master/ee15d577fb2f2d61bdaf700cfab894b286a5762d.jpg?1486753229",
        "records_count": 123,
        "created_at": "2016-05-03T19:06:59.929Z"
    },
    "work": {
        "id": 3994,
        "title": "ご注文はうさぎですか？",
        "title_kana": "ごちゅうもんはうさぎですか",
        "media": "tv",
        "media_text": "TV",
        "released_on": "2014-04-10",
        "released_on_about": "",
        "official_site_url": "http://www.gochiusa.com/",
        "wikipedia_url": "http://ja.wikipedia.org/wiki/%E3%81%94%E6%B3%A8%E6%96%87%E3%81%AF%E3%81%86%E3%81%95%E3%81%8E%E3%81%A7%E3%81%99%E3%81%8B%3F#.E3.83.86.E3.83.AC.E3.83.93.E3.82.A2.E3.83.8B.E3.83.A1",
        "twitter_username": "usagi_anime",
        "twitter_hashtag": "gochiusa",
        "images": {
            "recommended_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
            "facebook": {
                "og_image_url": ""
            },
            "twitter": {
                "mini_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=mini",
                "normal_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=normal",
                "bigger_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
                "original_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=original",
                "image_url": ""
            }
        },
        "episodes_count": 12,
        "watchers_count": 1463,
        "season_name": "2014-spring",
        "season_name_text": "2014年春"
    }
}
```

## DELETE /v1/me/reviews/:id

作成した記録を削除することができます。

**このリクエストには `write` スコープが必要になります。**

### パラメータ

| 名前 | 概要             | データ例 |
| -- | -------------- | ---- |
| id | **\[必須]** 記録ID | 595  |

### リクエスト例

```
$ curl -X DELETE "https://api.annict.com/v1/me/reviews/595?access_token=(access_token)"
```

```
HTTP/1.1 204 No Content
```