短视频详情

短视频详情

接口地址：http://route.showapi.com/1564-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
type	String		1033	是	视频类型,只能为 [1033,1060,1059,1058,1062,1061,1063,1066,1064,1067,1065]中的一个 1033=>推荐 1060=>影视 1059=>搞笑 1058=>音乐 1062=>小品 1061=>娱乐 1063=>社会 1066=>生活 1064=>猎奇 1067=>游戏 1065=>呆萌
page	String		1	否	页数
cate	String		list	是	请求类型,只能为"list"
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1564-1","my_appId","my_appSecret") .addTextPara("type","1033") .addTextPara("page","1") .addTextPara("cate","list") .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	约定参数
source	String	一米五的小个子	视频作者
tag	String	表演	视频标签
title	String	鸡蛋穿瓶子魔术，原来是这样做到的，我也学会了	视频标题
avatar	String	//publish-pic-cpu.baidu.com/b46df9c5-0692-4651-9b46-95c3b466dce2.jpeg	视频作者头像
brief	String	鸡蛋穿瓶子魔术，原来是这样做到的，我也学会了	视频描述
duration	String	12	视频时长，秒
playbackCount	String	123	视频的播放次数
thumbUrl	String	//publish-pic-cpu.baidu.com/96bf4af6-5338-42e4-acaa-83f0dd91a143.jpeg@w_1280,h_718	视频缩略图
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "717470c7022d48e1a011e03a4516fd72", "showapi_res_code": 0, "showapi_res_body": { "0": { "source": "小乔神技能", "tag": "生活", "title": "泡打粉、小苏打和酵母粉它们有什么区别？看完别再用错了，快看看", "avatar": "//publish-pic-cpu.baidu.com/537ce9ec-ff0d-4a45-b728-bc6322cf8eec.png", "brief": "泡打粉、小苏打和酵母粉它们有什么区别？看完别再用错了，快看看！生活小技巧，生活小窍门，生活小妙招，生活小技能。", "url": "https://vd3.bdstatic.com/mda-im5cusaf4mpgg7kh/mda-im5cusaf4mpgg7kh.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 80, "playbackCount": 50885, "thumbUrl": "//publish-pic-cpu.baidu.com/1e9d9c6c-1ee1-4c97-b16f-d52fbc66d759.jpeg@w_770,h_432" }, "1": { "source": "格斗世界官方", "tag": "体育", "title": "日本拳手出场嘚瑟扭屁股挑衅，中国跤王暴揍绞杀观众看不惯扔水瓶", "avatar": "//publish-pic-cpu.baidu.com/7bf8861a-3a04-4fb7-b446-a09bce1cf808.png", "brief": "日本拳手出场嘚瑟扭屁股挑衅，遭中国跤王暴揍绞杀观众看不惯扔水瓶、lebron", "url": "https://vd3.bdstatic.com/mda-imvpa53ufpwtiqb2/mda-imvpa53ufpwtiqb2.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 187, "playbackCount": 44957, "thumbUrl": "//publish-pic-cpu.baidu.com/5173a099-1e81-4b4e-b3e6-c82734f440f1.jpeg@w_786,h_441" }, "2": { "source": "动漫欢乐圈", "tag": "旅游", "title": "非洲吃人部落，这些人看起来好恐怖啊！", "avatar": "//publish-pic-cpu.baidu.com/38278d58-9b0f-4290-93de-085936531387.png", "brief": "非洲吃人部落，这些人看起来好恐怖啊！", "url": "https://vd3.bdstatic.com/mda-imhpxuuemqvrvsm9/mda-imhpxuuemqvrvsm9.mp4?playlist=%5B%22hd%22%5D", "duration": 12, "playbackCount": 70027, "thumbUrl": "//publish-pic-cpu.baidu.com/cf826245-1f54-4967-82d8-b16acb773dde.jpeg@w_660,h_370" }, "3": { "source": "素手映红梅", "tag": "财经", "title": "听过马云爸爸唱歌吗？短短的一句，就能看出台下没少下功夫啊", "avatar": "//publish-pic-cpu.baidu.com/c16a5fa9-92cc-469e-8116-67fe85c2a0c6.png", "brief": "听过马云爸爸唱歌吗？短短的一句，就能看出台下没少下功夫啊", "url": "https://vd3.bdstatic.com/mda-im6m7i0uhidkreek/mda-im6m7i0uhidkreek.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 15, "playbackCount": 37794, "thumbUrl": "//publish-pic-cpu.baidu.com/7c0f2679-dd57-489f-8d1d-86c67154d492.jpeg@w_660,h_370" }, "4": { "source": "老叶汽车工作室", "tag": "表演", "title": "诡异女孩参加达人秀把评委都吓得离开座位", "avatar": "//publish-pic-cpu.baidu.com/55b9b7db-7032-4198-acdd-1e4472a6b9de.jpeg", "brief": "诡异女孩参加达人秀把评委都吓得离开座位", "url": "https://vd3.bdstatic.com/mda-ijnp4qhtdkn6f075/mda-ijnp4qhtdkn6f075.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 203, "playbackCount": 124738, "thumbUrl": "//publish-pic-cpu.baidu.com/c0c92525-13ed-47c0-880a-3f2068e21010.jpeg@w_1280,h_718" }, "5": { "source": "娱乐美亚", "tag": "萌宠", "title": "这对双胞胎火了，两人打个架都在围观，看完不许笑！", "avatar": "//publish-pic-cpu.baidu.com/7da3e8ae-c6c1-4feb-9953-cc7f2a58685a.jpeg", "brief": "这对双胞胎火了，两人打个架都在围观，看完不许笑！", "url": "https://vd3.bdstatic.com/mda-im6ry4epe5qix4de/mda-im6ry4epe5qix4de.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 11, "playbackCount": 107695, "thumbUrl": "//publish-pic-cpu.baidu.com/85c46cd1-c923-4aa4-864d-8c4ae4f83221.jpeg@w_720,h_404" }, "6": { "source": "晨晨旅游说", "tag": "旅游", "title": "中国地理位置最好的省会，广州和西安败给了它，是你的家乡吗？", "avatar": "//publish-pic-cpu.baidu.com/0bbd608f-6c95-4a6b-8358-6a1c7c4957e2.jpeg", "brief": "中国地理位置最好的省会，广州和西安败给了它，是你的家乡吗？", "url": "https://vd3.bdstatic.com/mda-imjxm02cjs8c17x5/mda-imjxm02cjs8c17x5.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 87, "playbackCount": 4202, "thumbUrl": "//publish-pic-cpu.baidu.com/1a906c6e-0599-4225-a70b-7aba4d9956fe.jpeg@w_799,h_448" }, "7": { "source": "小雀幸儿", "tag": "财经", "title": "王健林再次预测三四线城市房价，句句实话，网友：咋不早说！", "avatar": "//publish-pic-cpu.baidu.com/848dd415-797f-4e19-9f07-0e6a0b5cb5bf.jpeg", "brief": "王健林再次预测三四线城市房价，句句实话，网友：咋不早说！", "url": "https://vd3.bdstatic.com/mda-imregnww86ky5emm/mda-imregnww86ky5emm.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 55, "playbackCount": 61506, "thumbUrl": "//publish-pic-cpu.baidu.com/fecde7e7-f045-40a2-aac1-d607514b2919.jpeg@w_864,h_486" }, "8": { "source": "一米五的小个子", "tag": "表演", "title": "鸡蛋穿瓶子魔术，原来是这样做到的，我也学会了", "avatar": "//publish-pic-cpu.baidu.com/b46df9c5-0692-4651-9b46-95c3b466dce2.jpeg", "brief": "鸡蛋穿瓶子魔术，原来是这样做到的，我也学会了", "url": "https://vd3.bdstatic.com/mda-ihurkurc6e36hie3/mda-ihurkurc6e36hie3.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 18, "playbackCount": 38749, "thumbUrl": "//publish-pic-cpu.baidu.com/91e08a6f-07b5-45fb-8398-82332e8602d1.jpeg@w_692,h_388" }, "9": { "source": "牵着兔子去散步", "tag": "萌宠", "title": "主人要把小狗炖了，不料拉布拉多叼着盆想吃狗肉，看完不许笑！", "avatar": "//publish-pic-cpu.baidu.com/482c1c2c-6b98-4969-8b34-33fe21540642.png", "brief": "主人要把小狗炖了，不料拉布拉多叼着盆想吃狗肉，看完不许笑！", "url": "https://vd3.bdstatic.com/mda-im6cdp2mja2ndksn/mda-im6cdp2mja2ndksn.mp4?playlist=%5B%22hd%22%2C%22sc%22%5D", "duration": 22, "playbackCount": 20998, "thumbUrl": "//publish-pic-cpu.baidu.com/96bf4af6-5338-42e4-acaa-83f0dd91a143.jpeg@w_1280,h_718" }, "ret_code": 0 } }