获取单个视频的打点信息

接口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...