设置视频打点

接口URL

http://api.polyv.net/v2/video/{userId}/saveKeyFrame

接口说明

设置视频打点

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userId}/saveKeyFrame中的{userid}需要替换为POLYV用户ID的值
vid string 视频的ID
desc string 打点描述,如果上传多个打点用英文逗号","隔开
seconds string 打点秒数【第seconds秒】,如果上传多个打点用英文逗号","隔开
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值

注意事项

    seconds(打点秒数【第seconds秒】)必须要小于视频长度;

    dess(打点描述)的个数必须要和seconds的个数相同。

响应参数

参数名 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data string 成功响应的数据

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "the key frame add successfully"
}

php请求示例

<?php
$desc = "第1个打点,第2个打点,第3个打点";
$seconds = "6,16,26";
$userid = "8205ac89d3";
$ptime = time()*1000;
$vid = "8205ac89d3ac2b9a7e72a71d16799803_8";
$secretkey = "kXmHMLeX6M";
$str = "ptime=$ptime"."&userid=$userid"."&vid=$vid".$secretkey;
$sign = strtoupper(sha1($str));
$url = "http://api.polyv.net/v2/video/$userid/saveKeyFrame?ptime=$ptime&desc=$desc&seconds=$seconds&vid=$vid&sign=$sign&";
$content = file_get_contents($url);
echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 请求参数为:

userid="8205ac89d3"
ptime="1474160490000"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

2. 将请求参数按照参数名字典顺序排列

ptime="1474160490000"
userid="8205ac89d3"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

3. 连接字符串

连接参数名与参数值,并在首尾加上secretkey的值(本示例的值为kXmHMLeX6M),如下:

ptime=1474160490000&userid=8205ac89d3&vid=8205ac89d39ad353f0350e5ce73a7244_8kXmHMLeX6M

4. 生成签名sign

sign为40位大写的SHA1值:

6944D661A54FDF3DDCE9D94230B4EBB91ECA1026
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...