文件拉取

快速入门

又拍云处理(文件拉取)基于云存储服务,您在使用它之前,请确保您已经注册又拍云账号并完成实名验证,请确保您已经创建云存储服务

价格方面,免费。


开发者指南

文件拉取流程如下: UPYUN Spider

特别地,本服务旨在为用户提供更便捷的资源上传方式,请您在提交资源链接时确保您拥有该资源的使用权或所有权。


提交处理任务

请求方法

对需要拉取的文件,以 POST 方法向 http://p0.api.upyun.com/pretreatment/ 提交处理任务,响应中返回任务 task_id。任务以异步的方式处理,处理完成后,回调通知用户处理结果。

curl -X POST \
    http://p0.api.upyun.com/pretreatment/ \
    -H "Authorization: UPYUN <Operator>:<Signature>" \
    -H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>" \
    -H "Content-MD5: <Content-MD5>" \
    -d "service=<service>" \
    -d "notify_url=<notify_url>" \
    -d "app_name=spiderman" \
    -d "tasks=<base64 编码后的任务字符串>"

认证鉴权

Authorization 详见签名认证

请求参数

参数 类型 必选 说明
service string 文件上传的服务名
notify_url string 回调通知地址,详见回调通知
tasks string 任务信息,详见 tasks 参数说明
app_name string 处理功能,spiderman 表示文件拉取

tasks 参数说明

1. 按 JSON 格式组装任务,一次请求 tasks 最多可以提交 10 个任务。 任务参数见功能

[
    {
        "url": "http://www.upyun.com/index.html",              // 需要拉取文件的 URL
        "random": false,                                       // 是否追加随机数, 默认 false
        "overwrite": true,                                     // 是否覆盖,默认 true
        "save_as": "/site/index.html",                         // 保存路径
    },
    …
]

2. 把 JSON 字符串 Base64 编码,得到 tasks

响应信息

[
    "35f0148d414a688a275bf915ba7cebb2",
    "98adbaa52b2f63d6d7f327a0ff223348",
    "c3103189fa906a5354d29bd807e8dc51",
    …
]

回调通知

任务处理完成后,向 notify_url 发送 HTTP POST 请求,请求体是回调信息。

curl -X POST \
    <notify_url> \
    -H "Authorization: UPYUN <Operator>:<Signature>" \
    -H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>" \
    -H "Content-MD5: <Content-MD5>" \
    -d "service=<service>" \
    # 其他参数...

回调信息

回调信息是 JSON 字符串,参数名及说明如下:

参数 类型 说明
task_id string 任务 ID
service string 文件上传的服务名
status_code integer 处理结果状态码,200 表示成功处理
path string 文件上传保存路径
error string 错误信息,空字符串表示无错误信息

回调签名

Authorization 详见签名认证


状态码表

状态码 说明
200 处理成功
400 参数错误
404 拉取的文件不存在
5xx 服务端错误。如遇此类错误,请反馈给售后或您的商务经理

功能

文件拉取(spiderman)

参数 类型 必选 说明
url string 需要拉取文件的 URL 地址
save_as string 文件上传存放路径
overwrite boolean 如果文件存在,是否覆盖,默认 true
content-md5 String 上传文件的 MD5 值,如果请求中文件太大计算 MD5 不方便,可以为空
content-type String 文件类型,默认使用文件扩展名作为文件类型
content-secret String 文件密钥,用于保护文件,防止文件被直接访问,见 Content-Secret 参数说明
x-upyun-meta-x String 文件元信息,见 Metadata
x-gmkerl-thumb string 图片处理参数,默认不进行图片处理。详见上传预处理(同步)
random boolean 是否在 url 后追加随机数,追加格式 ?<random>,默认 false。见「注」


如有疑问请 联系我们