API for Modifying Video Review Status

Updated: 2022-05-16 10:08:41

API URL

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

API Description

API for modifying video review status

Supported Format

JSON

Request Method

POST

Request Rate Limit

TRUE

Request Parameters

Parameter	Required	Type	Description
userid	Yes	string	User ID
ptime	Yes	string	Current timestamp in milliseconds (13 digits), valid for 3 minutes
vid	Yes	string	Video ID
reviewResult	Yes	string	Review status, e.g., pass. Currently only pass is supported
sign	Yes	string	Signature, a 40-character uppercase SHA1 value

JSON Example

{
  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: ""
}

Field Description

Field	Description
status	Success/Failure status
code	Success/Failure code
message	Success/Failure message
data	Success/Failure data

PHP Request Example

<?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;
?>

Signature Rules

Sort the request parameters (excluding sign) in dictionary order by parameter name, concatenate parameter names and values with "&", and append the secretkey value at the end. Generate a 40-character uppercase SHA1 value as the sign.

The following is an example process:

1. Sort the request parameters in dictionary order by parameter name:

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

2. Concatenate the string Use "&" to connect parameter names and values, and append the secretkey value at the end to generate a 40-character uppercase SHA1 value as the sign (the value in this example is AiDQw1mAmi), as follows:

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

3. Generate the signature sign

sign is a 40-character uppercase SHA1 value:

B2E2D7AAB9DFCC8CBFE7EDC919B5F8F6F4E104BC

POLYV Help Center