キャラクター
GET /v1/characters
Annictに登録されているキャラクター情報を取得することができます。
フィールド
| 名前 | 概要 |
|---|---|
| id | ID |
| name | 名前 |
| name_kana | 名前 (かな表記) |
| name_en | 名前 (英語表記) |
| nickname | ニックネーム |
| nickname_en | ニックネーム (英語表記) |
| birthday | 誕生日 |
| birthday_en | 誕生日 (英語表記) |
| age | 年齢 |
| age_en | 年齢 (英語表記) |
| blood_type | 血液型 |
| blood_type_en | 血液型 (英語表記) |
| height | 身長 |
| height_en | 身長 (英語表記) |
| weight | 体重 |
| weight_en | 体重 (英語表記) |
| nationality | 国籍 |
| nationality_en | 国籍 (英語表記) |
| occupation | 肩書き |
| occupation_en | 肩書き (英語表記) |
| description | キャラ紹介 |
| description_en | キャラ紹介 (英語表記) |
| description_source | キャラ紹介の引用元 |
| description_source_en | キャラ紹介の引用元 (英語表記) |
| favorite_characters_count | お気に入りに入れている人の数 |
| series | 紐づくシリーズ情報。取得できるフィールドは Series と同じです。 |
パラメータ
| 名前 | 概要 | 使用例 |
|---|---|---|
| fields | レスポンスボディに含まれるデータのフィールドを絞り込みます。 | fields=id,name |
| filter_ids | キャラクターをIDで絞り込みます。 | filter_ids=1,2,3 |
| filter_name | キャラクターを名前で絞り込みます。 | filter_name=株式会社 |
| page | ページ数を指定します。 | page=2 |
| per_page | 1ページに何件取得するかを指定します。デフォルトは 25 件で、50 件まで指定できます。 | per_page=30 |
| sort_id | キャラクターをIDで並び替えます。asc または desc が指定できます。 | sort_id=desc |
リクエスト例
$ curl -X GET https://api.annict.com/v1/characters?access_token=(access_token)&filter_ids=7510
{
"characters": [
{
"id": 7510,
"name": "岡部倫太郎",
"name_kana": "おかべりんたろう",
"name_en": "Okabe, Rintarou",
"kind": "STEINS;GATE",
"nickname": "鳳凰院凶真、おかりん",
"nickname_en": "Hououin, Kyouma",
"birthday": "12月14日",
"birthday_en": "December 14",
"age": "18歳",
"age_en": "18",
"blood_type": "A型",
"blood_type_en": "A",
"height": "177 cm",
"height_en": "177 cm",
"weight": "59 kg",
"weight_en": "59 kg",
"nationality": "日本",
"nationality_en": "Japan",
"occupation": "狂気のマッドサイエンティスト",
"occupation_en": "Crazy Mad Scientist",
"description": "未来ガジェット研究所のラボメンNo.001にして、ラボの創設者。東京電機大学1年生。まゆりや橋田からは「オカリン」と呼ばれている。実家は青果店。",
"description_en": "",
"description_source": " Wikipedia【STEINS;GATEの登場人物】",
"description_source_en": "",
"favorite_characters_count": 13,
"series": {
"id": 50,
"name": "Steins;Gate",
"name_ro": "",
"name_en": ""
}
}
],
"total_count": 1,
"next_page": null,
"prev_page": null
}