Move Video to Specified Category

Updated: 2022-09-02 18:08:07

API Description

1、通过子账号id和视频id，修改视频所属的分类，支持批量修改
2、接口支持https协议

API URL

http://api.polyv.net/v3/video/update-category

Online API Call

Request Method

POST

API Constraints

The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details

Request Parameter Description

Parameter	Required	Type	Description
appId	true	String	POLYV VOD sub-account appId. Retrieval path: POLYV VOD Console -> Settings -> Account Management
timestamp	true	Long	Current time in milliseconds, valid for 3 minutes
sign	true	String	Signature, 32-character uppercase MD5 value See MD5 Signature Generation Rules
vids	true	String	Video IDs, multiple IDs separated by commas. Example: "1b448be32370f4822ac40fd926112a66_1,1b448be323d66f3dae8db5af9f1fdce6_1"; Retrieval path: POLYV VOD Console -> Video List; Also obtainable from Upload Video;
cateId	false	String	Video category ID. Obtainable from Get Categories and Subcategories

Example

http://api.polyv.net/v3/video/update-category

Form Parameters:

vids=1b448be32370f4822ac40fd926112a66_1%2C1b448be323d66f3dae8db5af9f1fdce6_1&cateId=1617160372987&appId=a0Wmol5EwX&sign=197679CCF105DD80E0378BEF75993D31&timestamp=1617950661602

Response Parameter Description

Parameter	Type	Description
code	Integer	Response status code. 200 indicates success, non-200 indicates failure See Global Error Description
status	String	Response status text
requestId	String	Business request ID for troubleshooting on client/server side
error	Object	Detailed error information returned on failure [See error field description](/vod/api/sub_account/sub_move_video.md?id=error字段说明], returns empty on success
data	Object	Returns empty on both success and failure

error Field Description

Field	Type	Description
code	Integer	Error code
desc	String	Error description See Global Error Description

Java Request Example

For quick integration of base code, please download the relevant dependency source code. Click to download source code. After downloading, add it to your own source project. HttpUtil.java and VodSignUtil.java in the test case are included in the download file.

It is strongly recommended to use the VOD Java SDK for API integration. The VOD Java SDK provides unified encapsulation and optimization for API call logic, exception handling, data signing, and HTTP request thread pool.

private static final Logger log = LoggerFactory.getLogger(VodSubAccountTest.class);

/**
 * 移动视频到指定分类
 * @throws Exception
 * @throws NoSuchAlgorithmException
 */
@Test
public void testMoveSubVideo() throws Exception, NoSuchAlgorithmException {
        //公共参数,填写自己的实际参数
        String appId = super.appId;
        String appSecret = super.appSecret;
        String timestamp = String.valueOf(System.currentTimeMillis());

        //业务参数
        String url = "http://api.polyv.net/v3/video/update-category";
        String vids = "1b448be32370f4822ac40fd926112a66_1,1b448be323d66f3dae8db5af9f1fdce6_1";
        String cateId = "1617160372987";

        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp", timestamp);
        requestMap.put("vids", vids);
        requestMap.put("cateId", cateId);

        //用md5进行签名，使用子账号的secretKey签名
        requestMap.put("sign", VodSignUtil.getSignMd5(requestMap, appSecret));
        String response = HttpUtil.postFormBody(url, requestMap);
        log.debug("测试移动视频到指定分类,{}", response);
        //do somethings
}

Response Example

For system global error descriptions, see Global Error Description

Success Example

{
    "requestId": "8faa1225-111d-401c-84c8-b011dd8950a6", 
    "code": 200, 
    "status": "success", 
    "error": null, 
    "data": null
}

Error Example

{
    "requestId": "e7544473-250a-40eb-b53b-8768195617e0", 
    "code": 403, 
    "status": "error", 
    "error": {
        "code": 104, 
        "desc": "invalid signature"
    }, 
    "data": null
}

VOD Server API