获取单个视频的打点信息

接口URL

http://api.polyv.net/v2/video/{userid}/keyframe/{vid}

接口说明

(接口调用有频率限制,详细请查看)

获取单个视频的打点信息

返回结果支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID
vid true string 视频ID
sign true string 签名,40位大写的sha1值
ptime true string 当前13位毫秒级时间戳,3分钟内有效

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: {
  duration: "00:00:15",
  keyframeList: [
    {
    seconds: 6,
    keyContent: "第一个打点"
    },
    {
    seconds: 10,
    keyContent: "第二个打点"
    },
    {
    seconds: 12,
    keyContent: "第三个打点"
    }
  ]
  }
}

返回错误json

{
  code: 400,
  status: "error",
  message: "sign can not be empty.",
  data: ""
}

字段说明

字段 说明
duration 返回时长
keyframeList 打点信息列表
seconds 打点时间点,单位秒
keyContent 打点详情

PHP示例代码

<?php
$userid="efbb4ae8ac";
$vid="efbb4ae8ac0b8ba3af7af27e3f04db7a_e";
$ptime=time()*1000;
$secrectKey="secrectKey";
$sign=strtoupper(sha1("ptime=".$ptime."&vid=".$vid.$secrectKey));
$url="http://api.polyv.net/v2/video/$userid/keyframe/$vid?ptime=$ptime&sign=$sign";
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
$result=curl_exec($ch);
curl_close($ch);
print_r($result);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

"ptime" = "1495608788000"
"vid" = "efbb4ae8aca0699b6718dc1df84914b5_e"

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

"ptime" = "1495608788000"
"vid" = "efbb4ae8aca0699b6718dc1df84914b5_e"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为hbjCVBhnth),如下:

ptime=1495608788000&vid=efbb4ae8aca0699b6718dc1df84914b5_ehbjCVBhnth

4、生成签名sign

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