# 根据直播频道及场次和视频ID查询直播转存视频相关信息

### 接口URL

```
http://api.polyv.net/v2/video/{userid}/get-live-playback
```

### 接口说明

```
根据直播频道及场次和视频ID查询直播转存视频相关信息
```

### 支持格式

```
JSON
```

### 请求方式

```
POST,GET
```

### 请求数限制

```
TRUE
```

### 请求参数

| 参数名       | 必选    | 类型及范围  | 说明                               |
| --------- | ----- | ------ | -------------------------------- |
| userid    | true  | string | POLYV用户ID                        |
| ptime     | true  | string | 当前时间的毫秒级时间戳（13位），3分钟内有效          |
| channelId | false | int    | 直播频道，例如：100000                   |
| sessionId | false | string | 直播的场次ID                          |
| vid       | false | string | 点播的视频ID,当这个查询字段不为空的时候，将忽略其他的查询条件 |
| sign      | true  | string | 签名，为40位大写的SHA1值                  |

#### PHP示例代码

```php
<?php
$userid="9f1e0689e1";//必选
$channelId=100000;
$ptime=time()*1000;//必选
$sessionId="xxxfjkddk9";
$vid="b0f7041324572aa5df1e91a971d3ec15_b"
$secretkey="secretkey";
$post_data = array (    
    "channelId" => $channelId,    
    "ptime" => $ptime,
	"vid" => $vid,
    "sessionId" => $sessionId
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/get-live-playback";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>
```

### 返回结果

### JSON示例

```json
{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
"vid": "b0f7041324bdb24f8948d44c84364d1b_b",
"fileSize": 91413940,
"fileUrl": "http://dl.videocc.net/b0f7041324/none_b0f7041324bdb24f8948d44c84364d1b_b_1.mp4",
"sessionId": "f5868alc4s",
"type": "alone",
"channelId": 206204
    }
  ]
}
```

### 字段说明

| 字段        | 说明                       |
| --------- | ------------------------ |
| code      | 返回码                      |
| status    | 返回状态                     |
| message   | 返回信息                     |
| vid       | 视频id                     |
| fileSize  | 文件大小,单位是B                |
| fileUrl   | 文件下载地址                   |
| type      | 频道的类型，alone为普通直播，ppt为三分屏 |
| sessionId | 直播频道的场次ID                |
| channelId | 直播频道ID                   |

### sign的生成规则

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