虎牙直播视频API接口

虎牙直播视频API接口

接口地址：http://route.showapi.com/1368-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称	类型	默认值	示例值	必须	描述
page	String		1	是	页码

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1368-1","my_appId","my_appSecret") .addTextPara("page","1") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
ret_code	Number	0	获取成功
data	Object[]		请填写参数描述
-  uid	Number	367138632	用户ID
-  screenshot	String	http://screenshot.dwstatic.com/yysnapshot/f4a7450e0e1a54daf2d3e75ae8e5188c6902ffcc	封面
-  isBluRay	Number	1
-  gameFullName	String	英雄联盟	游戏名称
-  liveSourceType	Number	0
-  gameHostName	String
-  screenType	String
-  boxDataInfo	String		请填写参数描述
-  privateHost	String		请填写参数描述
-  nick	String		昵称
-  recommendStatus	String		请填写参数描述
-  totalCount	Number		点击数
-  roomName	String		房间名称
-  avatar180	String		头像
-  gid	Number
-  recommendTagColor	String
-  recommendTagName	String
-  introduction	String		描述
-  bussType	String
...

返回示例：{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": 0, "data": [ { "uid": "304582356", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/481374b650542d1fd8682be4772e91d13fd31746", "isBluRay": "1", "gameFullName": "英雄联盟", "liveSourceType": "0", "gameHostName": "lol", "screenType": "0", "boxDataInfo": "", "privateHost": "hujiangjun", "nick": "贾克虎丶虎神", "recommendStatus": "3", "totalCount": "191575", "roomName": "║「 虎　神 」 世界第一贾克斯　　　　　 ║12-20", "avatar180": "http://huyaimg.dwstatic.com/avatar/1032/27/3a44c53cd62bc5e324921dc6c3e93b_180_135.jpg", "gid": "1", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "冲分之路-目前560", "bussType": "1" }, { "uid": "1271256459", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/1d120f46380d97d5ef0910380277476c93e9be0a", "isBluRay": "1", "gameFullName": "炉石传说", "liveSourceType": "0", "gameHostName": "hearthstone", "screenType": "0", "boxDataInfo": "", "privateHost": "a16789", "nick": "安德罗妮丶", "recommendStatus": "4", "totalCount": "183427", "roomName": "神抽狗协会", "avatar180": "http://huyaimg.dwstatic.com/avatar/1047/bc/bc06fb8973906c9c1292df49a49a18_180_135.jpg", "gid": "393", "recommendTagColor": "FF8C00", "recommendTagName": "超级明星", "introduction": "永动机7号PLs版 400金币起步。", "bussType": "1" }, { "uid": "294636272", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/4e41f6b723b5362656c484b065c509d884ae01ea", "isBluRay": "1", "gameFullName": "主机游戏", "liveSourceType": "0", "gameHostName": "ZJGAME", "screenType": "0", "boxDataInfo": "", "privateHost": "chuhe", "nick": "Style丶楚河-90327", "recommendStatus": "4", "totalCount": "72162", "roomName": "│楚 河： 我每天都好饿啊 │", "avatar180": "http://huyaimg.dwstatic.com/avatar/1086/bf/fd6f69d69c0015eaface1f6024869e_180_135.jpg", "gid": "1964", "recommendTagColor": "FF8C00", "recommendTagName": "超级明星", "introduction": "最精彩的游戏直播~", "bussType": "2" }, { "uid": "355399519", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/4d9ed9fccad48649480b9fd0f278fb18ce557e6c", "isBluRay": "0", "gameFullName": "美食", "liveSourceType": "6", "gameHostName": "2752", "screenType": "1", "boxDataInfo": "", "privateHost": "huwaixiaogege", "nick": "LD-熊出没", "recommendStatus": "0", "totalCount": "19266", "roomName": "【ＬＤ90518】熊二户外直播 变态辣 招收主播加Q群562917581", "avatar180": "http://huyaimg.dwstatic.com/avatar/1094/12/4b466e5df5773d5badcfad240b5a60_180_135.jpg", "gid": "2752", "introduction": "辣辣辣排骨火锅！！！", "bussType": "8" }, { "uid": "1354160941", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/e5fd10c53cf5bd689490624ec6a53f87e005edc5", "isBluRay": "1", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "1496115569", "nick": "哈迪斯", "recommendStatus": "3", "totalCount": "153069", "roomName": "哈迪斯", "avatar180": "http://huyaimg.dwstatic.com/avatar/1025/47/ebd8d06fcad9e3048cfac92e515c48_180_135.jpg", "gid": "2336", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "哈迪斯：王者上星李白教学~", "bussType": "3" }, { "uid": "73274903", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/9704aae1c920c70c16952b9925647bf4aae7ff8c", "isBluRay": "1", "gameFullName": "英雄联盟", "liveSourceType": "0", "gameHostName": "lol", "screenType": "0", "boxDataInfo": "", "privateHost": "bashen", "nick": "第一蛮王八神", "recommendStatus": "3", "totalCount": "168818", "roomName": " ┊ 八 神 ¨国服最虎蛮王 新浪微博:LOL八神蛮王”新", "avatar180": "http://huyaimg.dwstatic.com/avatar/1060/6d/3b6b0db6cf837cf5c4981f1219febf_180_135.jpg", "gid": "1", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "史上最强蛮王 能抗住我三刀的只有真眼", "bussType": "1" }, { "uid": "391793659", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/95619de9c0b845bbc45dc39cce46b3e8307239dd", "isBluRay": "0", "gameFullName": "天天狼人杀", "liveSourceType": "0", "gameHostName": "2774", "screenType": "0", "boxDataInfo": "", "privateHost": "306242894", "nick": "腿毛", "recommendStatus": "29", "totalCount": "103317", "roomName": "║ G° 腿 毛 ✤ «狼人杀盘盘大枪爹» ║", "avatar180": "http://huyaimg.dwstatic.com/avatar/1075/87/2c31777b26310da5e73022fc338ecf_180_135.jpg", "gid": "2774", "recommendTagColor": "f13516", "recommendTagName": "魅力新星", "introduction": "虎牙第一怂~", "bussType": "3" }, { "uid": "1641158455", "screenshot": "http://huyaimg.dwstatic.com/cdnimage/anchorpost/1036/17/8eac45f50020b000a74ffeb923c3f7_1663.jpg", "isBluRay": "0", "gameFullName": "星秀", "liveSourceType": "0", "gameHostName": "xingxiu", "screenType": "0", "boxDataInfo": "", "privateHost": "1861844750", "nick": "9130贝贝", "recommendStatus": "0", "totalCount": "10037", "roomName": "丨 大 黑 牛 ： 自古真心留不住，偏偏套路得人心丨每天稳定", "avatar180": "http://huyaimg.dwstatic.com/avatar/1036/17/8eac45f50020b000a74ffeb923c3f7_180_135.jpg", "gid": "1663", "introduction": "虎牙第一黑", "bussType": "8" }, { "uid": "128488364", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/50f6be9bf491b0ec3347b79391a9aae3371e9387", "isBluRay": "0", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "litaibai90323", "nick": "China、李太白", "recommendStatus": "3", "totalCount": "99467", "roomName": "China、李太白", "avatar180": "http://huyaimg.dwstatic.com/avatar/1063/4d/adedb36a705a28ebfad5aef5864cc2_180_135.jpg", "gid": "2336", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "太白归来，从来开始", "bussType": "3" }, { "uid": "1169407747", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/71fb6d666bb7de41606121c0df3f79506426f030", "isBluRay": "0", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "chaojie", "nick": "东辰-小潮", "recommendStatus": "3", "totalCount": "59564", "roomName": "┋ ♂ ‹小 潮› ✦ 职业大小姐 　┋", "avatar180": "http://huyaimg.dwstatic.com/avatar/1054/55/0d5a62d291fbee8362e775e6d62724_180_135.jpg", "gid": "2336", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "国服大小姐：你离王者只差一个小潮！", "bussType": "3" }, { "uid": "1009333046", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/07a9065b660b5ff31b6426967f7c91d34b1288c8", "isBluRay": "0", "gameFullName": "英雄联盟", "liveSourceType": "0", "gameHostName": "lol", "screenType": "0", "boxDataInfo": "", "privateHost": "lafeng", "nick": "拉风龙", "recommendStatus": "3", "totalCount": "100382", "roomName": "┆「 拉风龙 」 电一王者千速人马 　　 ┆", "avatar180": "http://huyaimg.dwstatic.com/avatar/1030/b7/95f4e8360430103ed697f829661272_180_135.jpg", "gid": "1", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "文化人教逆风局打法 输一把送10000卷", "bussType": "1" }, { "uid": "1089197997", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/e4a832572fa33b654a5e3c54789175db24204ac3", "isBluRay": "0", "gameFullName": "球球大作战", "liveSourceType": "0", "gameHostName": "qiuqiu", "screenType": "0", "boxDataInfo": "", "privateHost": "qiuqiujiaofu", "nick": "球球教父", "recommendStatus": "3", "totalCount": "59075", "roomName": "┃球球教父：球球大作战双刷创始人┃", "avatar180": "http://huyaimg.dwstatic.com/avatar/1045/5e/40c55637bdd63ab3e9cb842c78185e_180_135.jpg", "gid": "2411", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "你迷人的分身。", "bussType": "3" }, { "uid": "469899586", "screenshot": "http://huyaimg.dwstatic.com/cdnimage/anchorpost/1099/82/ff98717a54b6deaa3c11016f5b7306_2336_1494490068.jpg", "isBluRay": "1", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "390951105", "nick": "虎牙Tv帝王", "recommendStatus": "0", "totalCount": "56730", "roomName": "┊ ‹G› 帝 王 ‥ 王 者 荣 耀 ┊", "avatar180": "http://huyaimg.dwstatic.com/avatar/1099/82/ff98717a54b6deaa3c11016f5b7306_180_135.jpg", "gid": "2336", "introduction": "荣耀史诗级貂蝉秀~~来撩我啊~~", "bussType": "3" }, { "uid": "1623419169", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/41584182faf93799498397735e4afe7bc03f25c8", "isBluRay": "1", "gameFullName": "球球大作战", "liveSourceType": "0", "gameHostName": "qiuqiu", "screenType": "0", "boxDataInfo": "", "privateHost": "qisui", "nick": "七岁就很萌", "recommendStatus": "3", "totalCount": "55066", "roomName": "┃七岁就很萌：球球一姐┃", "avatar180": "http://huyaimg.dwstatic.com/avatar/1009/e4/89e2d768904e7f35479d5c6ef18d24_180_135.jpg", "gid": "2411", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "七岁：第一次 直播 好紧张", "bussType": "3" }, { "uid": "1269566278", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/ede5b79af207730ce5d6dcaa579d82c0f6b9cadc", "isBluRay": "1", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "qingtiandiyi", "nick": "晴天", "recommendStatus": "3", "totalCount": "54444", "roomName": "│　 哈迪斯 > 第一李白 │", "avatar180": "http://huyaimg.dwstatic.com/avatar/1024/9f/e059c077dab697b8e386d4fb9e0ae0_180_135.jpg", "gid": "2336", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "虎牙第一韩信~！视觉上的享受~！", "bussType": "3" }, { "uid": "1346609715", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/c0fbd733434e2bec6262a9bbb6fbf8c147097d0c", "isBluRay": "1", "gameFullName": "英雄联盟", "liveSourceType": "1", "gameHostName": "lol", "screenType": "0", "boxDataInfo": "", "privateHost": "msi", "nick": "MSI冠军赛", "recommendStatus": "0", "totalCount": "91997", "roomName": "┃ 2017MSI季中冠军赛 ┃ ", "avatar180": "http://huyaimg.dwstatic.com/avatar/1042/6f/3626ef611e990cbbcefab8e1bbc561_180_135.jpg", "gid": "1", "introduction": "MSI季中冠军赛重播", "bussType": "1" }, { "uid": "236691346", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/c0af2616c9930a2fc4f1df52b5f52d0439170358", "isBluRay": "1", "gameFullName": "王者荣耀", "liveSourceType": "0", "gameHostName": "wzry", "screenType": "0", "boxDataInfo": "", "privateHost": "xiaota", "nick": "小塔", "recommendStatus": "3", "totalCount": "53408", "roomName": "┇ 小塔ＴＴ 王者声优暖男~ ┇", "avatar180": "http://huyaimg.dwstatic.com/avatar/1017/4d/a0965008cadd0093bb5969bf46908f_180_135.jpg", "gid": "2336", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "AG解说小塔 每天都是晋级赛", "bussType": "3" }, { "uid": "20354678", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/f4532d17010b24d18517df47c24f9eeebeb1816f", "isBluRay": "0", "gameFullName": "球球大作战", "liveSourceType": "0", "gameHostName": "qiuqiu", "screenType": "0", "boxDataInfo": "", "privateHost": "164541401", "nick": "神奇的蜡笔", "recommendStatus": "3", "totalCount": "45177", "roomName": "┆「 球球大作战 」小蜡笔 ：球球大作战搞事play", "avatar180": "http://huyaimg.dwstatic.com/avatar/1049/87/6ed019f80b8a52f3c02757b9958e1e_180_135.jpg", "gid": "2411", "recommendTagColor": "00BFFF", "recommendTagName": "大神推荐", "introduction": "聊天第一 霸屏第二", "bussType": "3" }, { "uid": "1061095494", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/941d9c06f573a7e644ee5e41cc51817409a050d5", "isBluRay": "0", "gameFullName": "球球大作战", "liveSourceType": "0", "gameHostName": "qiuqiu", "screenType": "0", "boxDataInfo": "", "privateHost": "1124736449", "nick": "明仔~", "recommendStatus": "0", "totalCount": "43873", "roomName": " ┊ «明 仔» Ｇ ➩ :::爱生存爱明仔 ┊", "avatar180": "http://huyaimg.dwstatic.com/avatar/1023/4b/172cb5a9efac5b7253c9ec1e3db297_180_135.jpg", "gid": "2411", "introduction": "仔仔：生存生存", "bussType": "3" }, { "uid": "511018659", "screenshot": "http://screenshot.dwstatic.com/yysnapshot/d603204fdda0b19ea543d34b5c521102c34a20f6", "isBluRay": "1", "gameFullName": "球球大作战", "liveSourceType": "0", "gameHostName": "qiuqiu", "screenType": "0", "boxDataInfo": "", "privateHost": "434206614", "nick": "爱尚丶启点", "recommendStatus": "0", "totalCount": "42014", "roomName": "┆等待冠名 ‹启 点 ›::: 处妹狂魔7.6666 ┆ ", "avatar180": "http://huyaimg.dwstatic.com/avatar/1032/17/79a6cd7b30ae9625e1d1027c2f33db_180_135.jpg", "gid": "2411", "introduction": "我丑所以只能直播了", "bussType": "3" } ] } }