1. 首页
  2. 云处理
  3. 图片拼接(异步)

图片拼接(异步)

快速入门

图片拼接(异步)服务基于云存储服务,您在使用它之前,请确保您已经注册又拍云账号并完成实名验证,请确保您已经创建云存储服务

价格方面,它是免费的。

开发者指南

图片拼接是把云存储中的多张图片拼接在一起,拼接方式多种多样。

云存储中的图片拼接

请求方法

对已经存在云存储中的图片,以 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=jigsaw" \
    -d "tasks=<base64 编码后的任务字符串>"

认证鉴权

Authorization 详见签名认证

请求参数

参数 类型 必选 说明
service string 图片所在的服务名
notify_url string 回调通知地址,详见回调通知
tasks string 任务信息,详见 tasks 参数说明
app_name string 处理功能,jigsaw 表示图片拼接

tasks 参数说明

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

[
    {
        "image_matrix": [                       // 需要拼接的图片路径和拼接方式
            ["/image/top.jpg"],
            ["/image/bottom.jpg"]
        ],
        "x-gmkerl-thumb": "/format/jpg",        // 其他的图片处理功能
        "save_as": "/jigsaw/case1.jpg"      // 拼接后图片的保存路径
    },
    …
]

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

响应信息

  • 任务提交成功:返回 200,响应体是一组按任务提交先后顺序排序的 task_id。例如:

    [ “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 无效任务
5xx 服务端错误。如遇此类错误,请反馈给售后或您的商务经理

功能

图片拼接(jigsaw)

参数 类型 必选 说明
image_matrix [][]string 需要拼接的图片路径和拼接方式
save_as string 拼接后图片的保存路径
x-gmkerl-thumb string 对拼接后的图片进行图片处理

说明

  • image_matrix 是个二维数组,图片拼接的方式根据二维数组来,第一维数组,表示行,第二维数组,表示列,合起来就是按行、按列拼接。具体按行(填第一维数组,第二维为空),按列(填第二维数组,第一维为空),按行列拼接,根据需求决定。

  • 图片拼接最多允许 10 张图片,即 image_matrix 最多允许 10 个 URI。

  • 默认情况下,拼接产生的图片格式为 PNG 格式,如果需要调整图片格式,可通过设置 x-gmkerkl-thumb 做格式转换。

如有疑问请 联系我们

这篇文章有帮助吗?

相关文章