如果需要对已保存在空间中的资源进行云处理并将结果持久化，可以使用 pfop 接口。

请求报文

请求语法

1. POST /pfop/ HTTP/1.1
2. Host: api.qiniu.com
3. Content-Type: application/x-www-form-urlencoded
4. Authorization: QBox <AccessToken>
5.  
6. <PfopRequestParams>
7.  

注意：要在 Authorization 头部的<AccessToken>前添加 QBox 和半角空格。

头部信息

访问权限

管理凭证方式。

请求参数

请求参数以表单形式组织，作为请求内容提交，格式如下：

1. bucket=<urlEncodedBucket>&key=<urlEncodedKey>&fops=<urlEncodedFops>&notifyURL=<urlEncodedPersistentNotifyUrl>&force=<Force>&pipeline=<Pipeline Name>

响应报文

响应语法

1. HTTP/1.1 200 OK
2. Content-Type: application/json
3. Content-Length: <PfopResponseContentLength>
4.  
5. <PfopResponseContent>
6.  

头部信息

响应内容

• 如果请求成功，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

1. {
2. "persistentId": <persistentId string>
3. }

• 如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

1. {
2. "error": "<ErrMsg string>"
3. }

响应状态码

故障排除

301跳转问题

如果遇到类似如下 301 跳转现象，请检查 pfop 的 URL 最后是否少了一个斜杠符号 /，误写成 http://api.qiniu.com/pfop：

1. W, [2014-04-05T00:14:07.748721 #686] WARN -- : 301 Moved Permanently => Qiniu::HTTP.post('http://api.qiniu.com/pfop')

正确写法是 http://api.qiniu.com/pfop/。

持久化处理结果通知

服务端按顺序完成所有指定的云处理操作后，会将处理结果状态提交到<persistentNotifyUrl>指向的网址。

请求报文

请求语法

1. POST <persistentNotifyUri> HTTP/1.1
2. Host: <persistentNotifyDomain>
3. Content-Type: application/json
4.  
5. <JsonStatusDescription>
6.  

头部信息

请求内容

用户获得的持久化云处理结果状态是一个 JSON 字符串，内容范例如下：

1. {
2. "id": "16864pauo1vc9nhp12",
3. "code": 0,
4. "desc": "The fop was completed successfully",
5. "inputKey": "sample.mp4",
6. "inputBucket": "dutest",
7. "items": [
8. {
9. "cmd": "avthumb/mp4/r/30/vb/256k/vcodec/libx264/ar/22061/ab/64k/acodec/libmp3lame",
10. "code": 0,
11. "desc": "The fop was completed successfully",
12. "error": "",
13. "hash": "FrPNF2qz66Bt14JMdgU8Ya7axZx-",
14. "key": "v-PtT-DzpyCcqv6xNU25neTMkcc=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
15. "returnOld": 0
16. },
17. {
18. "cmd": "avthumb/iphone_low",
19. "code": 0,
20. "desc": "The fop was completed successfully",
21. "error": "",
22. "hash": "FmZ5PbHMYD5uuP1-kHaLjKbrv-75",
23. "key": "tZ-w8jHlQ0__PYJdiisskrK5h3k=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
24. "returnOld": 0
25. },
26. {
27. "cmd": "avthumb/m3u8/noDomain/1/r/30/vb/256k/vcodec/libx264/ar/22071/ab/64k/acodec/libmp3lame",
28. "code": 0,
29. "desc": "The fop was completed successfully",
30. "error": "",
31. "hash": "Fi4gMX0SvKVvptxfvoiuDfFkCuEG",
32. "key": "8ehryqviSaMIjkVQDGeDcKRZ6qc=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
33. "returnOld": 0
34. },
35. {
36. "cmd": "avthumb/m3u8/noDomain/1/vb/440k",
37. "code": 0,
38. "desc": "The fop was completed successfully",
39. "error": "",
40. "hash": "FtuxnwAY9NVBxAZLcxNUuToR9y97",
41. "key": "s2_PQlcIOz1uP6VVBXk5O9dXYLY=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
42. "returnOld": 0
43. }
44. ],
45. pipeline: "0.default",
46. reqid: "ffmpeg.3hMAAH3p5Gupb6oT"
47. }