获取单个视频的首图

点击这里查看旧版

接口URL

http://api.polyv.net/v2/video/{userid}/get-image

接口说明

获取单个视频的首图

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id(在请求时不需提交该参数,仅作为接口url中的变量)
ptime true float 13位的当前时间毫秒级时间戳
t false int 值为1时,表示获取视频首图的缩略图
vid true string 视频的id
sign true string 签名

请求成功返回json示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "http://img.videocc.net/uimage/7/7d26575efe/6/7d26575efe7af7af4dcaa007d6298196_0.jpg"
}

请求失败返回json示例

{
  code: 400,
  status: "error",
  message: "the sign is not right.",
  data: ""
}

字段说明

字段 说明
code 请求返回的状态码
status 请求返回的状态
message 请求返回的信息
data 请求返回的数据

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8"); 
$userid="0c4b2b3748";
$ptime=time()*1000;//13位
$t=1;//值为1时,表示获取视频首图的缩略图 false 其他值是大图
$vid="0c4b2b37489e705c0d563cec816d5ab9_0";
$secretkey="l2b58rVt2b";
$str="ptime=".$ptime."&t=".$t."&vid=".$vid.$secretkey;
$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/{$userid}/get-image";
$post_data = array (
    "ptime" => $ptime,
    "t" => $t,
    "vid" => $vid,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post数据
curl_setopt($ch, CURLOPT_POST, 1);
// post的变量
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

sign的生成规则

ptime=参数&t=参数&vid=参数secretkey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。例如如果这里没有t,则不需要拼接&t=参数)

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