火山直播小视频采集

火山直播小视频采集

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

参数名称	类型	默认值	示例值	必须	描述
url	String		https://www.huoshan.com/share/video/6434689166562299137/	是	火山小视频微信分享出来的url

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1437-1","my_appId","my_appSecret") .addTextPara("url","https://www.huoshan.com/share/video/6434689166562299137/") .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	非0表示获取失败
data	Object[]
-  status	Number	102	状态码
-  create_time	Number	1498192846	创建时间
-  video	Object[]
-  location	String	沈阳	地区城市
-  media_type	Number	4	分类id
-  text	String	老板创业菜，月销量3000份与您全程分享	标题
-  author	Object[]
-  city	String	沈阳	城市
-  fan_ticket_count	Number	30998	投票数
-  avatar_large	Object[]
-  url_list	Object[]
-  0	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  1	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  2	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  uri	String
-  short_id	Number	97275209	用户id
-  level	Number	1	用户等级
-  gender	Number
-  id_str	String
-  avatar_medium	Object[]
-  url_list	Object[]
-  0	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  1	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  2	String	http://p9.pstatp.com/live/720x720/194600120f405ba4a21f.jpg	头像地址
-  uri	String	720x720/194600120f405ba4a21f	请填写参数描述
-  signature	String	每天都在更新菜品，\n厨房那些窍门你都知道吗。\n很高兴与大家分享\n还有一些新鲜事。\n喜欢就关注我吧	描述
-  avatar_thumb	Object[]
-  nickname	String	老辽菜 1718	用户昵称
-  id	Number	58602623742	用户id
-  id	Number		id
-  stats	Object[]		请填写参数描述
-  digg_count	Number	972	顶数量
-  play_count	Number	117611	播放量
-  comment_count	Number	139	评论数
-  income	Number	10710	关注数
-  share_count	Number	109	分享数
-  ticket	String	1071	票数
title	String		标题
img	String		封面图片
video	String		视频地址
...

返回示例：{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": 0, "data": { "id": "6434689166562299137", "author": { "fan_ticket_count": 84787, "nickname": "灿友老辽菜 1718", "short_id": 97275209, "avatar_thumb": { "url_list": [ "http://p1.pstatp.com/live/100x100/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/100x100/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/100x100/194600120f405ba4a21f.jpg" ], "uri": "100x100/194600120f405ba4a21f" }, "avatar_large": { "url_list": [ "http://p1.pstatp.com/live/1080x1080/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/1080x1080/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/1080x1080/194600120f405ba4a21f.jpg" ], "uri": "1080x1080/194600120f405ba4a21f" }, "city": "沈阳", "id": 58602623742, "level": 1, "avatar_medium": { "url_list": [ "http://p1.pstatp.com/live/720x720/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/720x720/194600120f405ba4a21f.jpg", "http://pb3.pstatp.com/live/720x720/194600120f405ba4a21f.jpg" ], "uri": "720x720/194600120f405ba4a21f" }, "gender": 1, "app_id": 1112, "id_str": "58602623742", "signature": "厨师行业，\n美食制作，与分享，\n欢迎喜欢的朋友关注！\n微❤1164404792" }, "text": "老板创业菜，月销量3000份与您全程分享", "media_type": 4, "location": "沈阳", "status": 102, "stats": { "digg_count": 2822, "play_count": 499917, "ticket": 1249, "income": 12490, "share_count": 384 }, "sharer": { "id": 0, "fan_ticket_count": 0, "level": 1, "nickname": "0", "gender": 0, "id_str": "0", "signature": "", "city": "" }, "create_time": 1498192846, "video": { "url_list": [ "http://hotsoon.snssdk.com/hotsoon/item/video/_playback/?video_id=b06159f6966a4598a8bfb8c102053ec3&line=0&app_id=1112&watermark=0", "http://hotsoon.snssdk.com/hotsoon/item/video/_playback/?video_id=b06159f6966a4598a8bfb8c102053ec3&line=1&app_id=1112&watermark=0" ], "cover": { "url_list": [ "http://p1.pstatp.com/large/29a9000a0e698e5712ae.jpg", "http://pb3.pstatp.com/large/29a9000a0e698e5712ae.jpg", "http://pb3.pstatp.com/large/29a9000a0e698e5712ae.jpg" ], "uri": "large/29a9000a0e698e5712ae" }, "duration": 13.356, "height": 426, "ratio": 1.79, "width": 238, "uri": "b06159f6966a4598a8bfb8c102053ec3" } } } }