## 3.8 英雄接口 ### 1.英雄列表 GET： ~~~ /api/v1/role ~~~ 接口概述：获取所有英雄数据 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per_page | int | 否 | 每页数据条数 | | token | string | 是 | 客户密钥 | | day | int | 否 | 可以填写1-7，1代表24小时内变动数据筛选；7代表一周内变动数据筛选，2-6以此类推；若不填写或填写错误此参数不生效 | | game_id | int | 否 | 游戏ID筛选 | 请求url示例 ~~~ /api/v1/role?page=1&per_page=100&token=XXXXX ~~~ ### 2.英雄详情 GET： ~~~ /api/v1/role/{role_id} ~~~ 接口概述：获取英雄详情数据 建议频率：查询时调用 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | role_id | int | 否 | 英雄ID | | token | string | 是 | 客户密钥 | 请求url示例 ~~~ /api/v1/role/8?token=XXXXX ~~~ ~~~ {{ "id": 428, //id "name": "Brand", //中文名 "name_en": "Brand", //英文名 "game_id": 1, //游戏id (1-lol,2-csgo,3-王者荣耀,4-dota2 ) "logo": "XXXXX.png", "icon": "XXXXX.png", "vertical_logo": "", //动画直播大头像 "img": "" //动画直播小头像 "status": 0, "role_talent": { //Dota才会有天赋数据 "talent_id": 24, //天赋ID "level": 10, //天赋等级 "direction": "left", //天赋树描述 "talent\_name": "+8.00 力量", //天赋中文名称 "talent\_name\_en": "special\_bonus\_strength\_8" //天赋英文名称 }, "lang": { "name_zh_tw": "英雄聯盟", //繁体 "name_es": "Liga de Leyendas", //西班牙语 "name_pt": "Liga dos lendários", //葡萄牙语 "name_fr": "League of Legends", //法语 "name_de": "League of Legends", //德语 "name_sv": "League of legends", //瑞典语 "name_ru": "Лига Легенд", //俄语 "name_uk": "Ліга Легенд", //乌克兰语 "name_da": "Liga af legender", //丹麦语 "name_pl": "Liga legend", //波兰语 "name_nl": "League of Legends", //荷兰语 "name_ko": "리그 오브 레전드", //韩语 "name_ms": "Liga legenda", //马来语 "name_tl": "Liga ng mga alamat", //他加禄语 "name_vi": "Liên Minh Huyền Thoại", //越南语 "name_el": "Λεγεώνα των Θρύλων", //希腊语 "name_tr": "Efsaneler Ligi", //土耳其语 "name_thai": "ลีกแห่งตำนาน" //泰语 "name_ar": " " //阿拉伯语 "name_hi": "" //印度语 } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | game\_id | string | 游戏id (1-lol,2-csgo,3-王者荣耀,4-dota2 ) | \--- | | icon | string | icon | \--- | | id | int | id | \--- | | img | string | 动画直播小头像 | \--- | | logo | string | logo | \--- | | name | string | 中文名 | \--- | | name\_en | string | 英文名 | \--- | | vertical\_logo | string | 动画直播大头像 | \--- | |lang | string | 多语言字段（英雄名） | \--- |