修改影片審核狀態的介面

更新時間：2022-05-16 10:08:41

介面URL

https://api.polyv.net/v2/video/{userid}/audit-video

介面說明

修改影片審核狀態的介面

支援格式

JSON

請求方式

POST

請求數限制

TRUE

請求參數

參數名	必選	類型	說明
userid	是	string	使用者ID
ptime	是	string	當前時間的毫秒級時間戳（13位），3分鐘內有效
vid	是	string	影片ID
reviewResult	是	string	審核的狀態，例如：pass，目前僅支援pass
sign	是	string	簽名，為40位大寫的SHA1值

JSON範例

{
  code: 200,
  status: "success",
  message: "success",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "vid不能为空",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "reviewResult不能为空",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "reviewResult值不对",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "视频ID和用户不对应",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "账号没有操作该接口的权限",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "视频不存在",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "只有审核不通过的视频才可以修改审核状态",
  data: ""
}

{
  code: 400,
  status: "error",
  message: "视频被判定为确认违规，无法修改审核状态，如有疑问请联系客服处理",
  data: ""
}

欄位說明

欄位	說明
status	成功/失敗狀態
code	成功/失敗代碼
message	成功/失敗訊息
data	成功/失敗資料

php請求範例

<?php
  $userid="8f8482aaab";
  $secretkey="AiDQw1mAmi";
  $vid="8f8482aaab8fe7ea12e3314a11a061fc_8";
  $reviewResult="pass";
  $ptime=time()*1000;
  $str="ptime=$ptime&reviewResult=$reviewResult&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/audit-video?ptime=$ptime&reviewResult=$reviewResult&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

簽名規則

將請求參數（sign除外）按照參數名字典順序排列，用「&」連接參數名與參數值，並在最後加上secretkey的值，生成40位大寫的SHA1值，作為sign。

以下是範例過程：

1. 將請求參數按照參數名字典順序排列為：

reviewResult="pass"
ptime="1476753635000";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

2. 連接字串 用「&」連接參數名與參數值，並在最後加上secretkey的值，生成40位大寫的SHA1值，作為sign（本範例的值為AiDQw1mAmi），如下：

ptime=1476753635000&reviewResult=pass&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成簽名sign

sign為40位大寫的SHA1值：

B2E2D7AAB9DFCC8CBFE7EDC919B5F8F6F4E104BC