MH-API (v0.1.0)

Download OpenAPI specification:Download

モンスターハンターAPI

Armors

防具一覧を取得します

防具を検索して一覧を返します（名前・スキル名・スロットによる絞り込み・ページネーション対応）

query Parameters

name	string 防具名（部分一致）
skill_name	string スキル名（部分一致）
slot	string スロット（完全一致）
limit	integer Default: 100 取得件数
offset	integer Default: 0 取得開始位置
sort	string ソート順 (asc/desc)

Responses

Response samples

200
400
500

Content type

application/json

{"armors": [{"defense": 0,
"id": "string",
"name": "string",
"required": [{"id": "string",
"name": "string"
}
],
"resistance": {"dragon": 0,
"fire": 0,
"ice": 0,
"lightning": 0,
"water": 0
},
"skills": [{"id": "string",
"name": "string"
}
],
"slot": "string"
}
],
"total": 0
}

防具詳細を取得します

指定されたIDの防具の詳細を返します。

path Parameters

id

required

string

防具ID

Responses

Response samples

200
400
404
500

Content type

application/json

{"defense": 0,
"id": "string",
"name": "string",
"required": [{"id": "string",
"name": "string"
}
],
"resistance": {"dragon": 0,
"fire": 0,
"ice": 0,
"lightning": 0,
"water": 0
},
"skills": [{"id": "string",
"name": "string"
}
],
"slot": "string"
}

System

ヘルスチェック

システムが稼働しているか確認する

Responses

Response samples

200

Content type

application/json

{"property1": "string",
"property2": "string"
}

DBヘルスチェック

データベースへの接続を確認する

Responses

Response samples

200
500

Content type

application/json

{"property1": "string",
"property2": "string"
}

アイテム検索

アイテム名の一覧を取得する

アイテムを検索して一覧を取得する（名前・モンスターIDによる絞り込み・ページネーション対応）

query Parameters

name	string アイテム名（部分一致）
monster_id	string モンスターID（完全一致）
limit	integer Default: 100 取得件数
offset	integer Default: 0 取得開始位置

Responses

Response samples

200
400
500

Content type

application/json

{"items": [{"item_id": "string",
"item_name": "string"
}
],
"limit": 0,
"offset": 0,
"total": 0
}

アイテム検索（1件）

アイテムを検索して、条件に合致するアイテムを1件取得する

path Parameters

itemId

required

string

アイテムID

Responses

Response samples

200
400
404
500

Content type

application/json

{"item": {"item_id": "string",
"item_name": "string"
}
}

アイテム検索（モンスター別）

指定のアイテムが取得可能なモンスターの一覧

path Parameters

monsterId

required

string

モンスターID

Responses

Response samples

200
400
404
500

Content type

application/json

{"items": [{"item": {"item_id": "string",
"item_name": "string"
}
}
],
"monster_id": "string",
"monster_name": "string"
}

モンスター検索

モンスター検索（複数件）

モンスターを検索して、条件に合致するモンスターを複数件取得する

query Parameters

MonsterIds	string モンスターIDs (カンマ区切り)
MonsterName	string モンスター名
UsageElement	string 使用属性
WeaknessElement	string 弱点属性
TribeName	string 種族名
FieldName	string フィールド名
ProductName	string 作品名
limit	integer Default: 100 取得件数
offset	integer Default: 0 取得開始位置
sort	string ソート順 (asc/desc)

Responses

Response samples

200
400
404
500

Content type

application/json

{"limit": 0,
"monsters": [{"another_name": "string",
"bgm": [{"name": "string",
"url": "string"
}
],
"category": "string",
"description": "string",
"element": "string",
"first_weak_attack": "string",
"first_weak_element": "string",
"image_url": "string",
"location": ["string"
],
"monster_id": "string",
"name": "string",
"name_en": "string",
"ranking": [{"ranking": "string",
"vote_year": "string"
}
],
"second_weak_attack": "string",
"second_weak_element": "string",
"title": ["string"
],
"weakness_attack": [{"blow": "string",
"bullet": "string",
"slashing": "string"
}
],
"weakness_element": [{"dragon": "string",
"fire": "string",
"ice": "string",
"thunder": "string",
"water": "string"
}
]
}
],
"offset": 0,
"total": 0
}

モンスター検索（1件）

モンスターを検索して、条件に合致するモンスターを1件取得する

path Parameters

id

required

string

モンスターID

Responses

Response samples

200
400
404
500

Content type

application/json

{"monster": {"another_name": "string",
"bgm": [{"name": "string",
"url": "string"
}
],
"category": "string",
"description": "string",
"element": "string",
"first_weak_attack": "string",
"first_weak_element": "string",
"image_url": "string",
"location": ["string"
],
"monster_id": "string",
"name": "string",
"name_en": "string",
"ranking": [{"ranking": "string",
"vote_year": "string"
}
],
"second_weak_attack": "string",
"second_weak_element": "string",
"title": ["string"
],
"weakness_attack": [{"blow": "string",
"bullet": "string",
"slashing": "string"
}
],
"weakness_element": [{"dragon": "string",
"fire": "string",
"ice": "string",
"thunder": "string",
"water": "string"
}
]
}
}

スキル検索

スキル一覧を取得する

スキルを検索して一覧を取得する（名前・説明文による絞り込み・ページネーション対応）

query Parameters

name	string スキル名（部分一致）
description	string 説明文（部分一致）
limit	integer Default: 100 取得件数
offset	integer Default: 0 取得開始位置

Responses

Response samples

200
400
500

Content type

application/json

{"skills": [{"description": "string",
"id": "string",
"level": [{"property1": "string",
"property2": "string"
}
],
"name": "string"
}
],
"total": 0
}

スキル検索（1件）

スキルを検索して、条件に合致するスキルを1件取得する

path Parameters

skillId

required

string

スキルID

Responses

Response samples

200
400
404
500

Content type

application/json

{"description": "string",
"id": "string",
"level": [{"property1": "string",
"property2": "string"
}
],
"name": "string"
}

Weapons

武器リストを検索します

指定されたクエリパラメータに基づいて武器のリストを返します。

query Parameters

weapon_id	string 武器ID (完全一致)
name	string 武器名 (部分一致を想定)
limit	integer Default: 20 取得件数
offset	integer Default: 0 取得開始位置
sort	string ソートフィールド (asc/desc)
order	integer ソート順 (0:昇順, 1:降順)

Responses

Response samples

200
400
500

Content type

application/json

{"limit": 0,
"offset": 0,
"total_count": 0,
"weapons": [{"attack": "string",
"critical": "string",
"description": "string",
"element_attack": "string",
"image_url": "string",
"name": "string",
"rare": "string",
"sharpness": "string",
"weapon_id": "string"
}
]
}