v3/photo/save_pic

调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

目录

1 功能说明

1. 接口功能:为应用的图片提供存储功能。

2. 功能描述:
(1)为支持某些应用调用互动性接口时,希望使用个性化图片的需求(例如应用在调用分享接口时,希望不同用户使用不同的图片),特别提供本接口。
(2)应用调用本接口,可将指定的图片存储在平台提供的图片存储系统中,并将图片的url返回给应用。
(3)应用可以通过调用v3/photo/get_pic接口来获取用户在应用中上传过的图片的url。
(4)应用图片存储在平台提供的图片存储系统中,应用调用时不使用应用的流量带宽,可以为应用节省流量带宽。

3. 接口调用限制:
(1)每款应用最多可上传图片1千万张,超过限制之后,新上传的图片将覆盖最早上传的。
(2)应用中的每个用户最多可上传图片100张,超过限制之后,新上传的图片将覆盖最早上传的。
(3)每张图片大小最大为2M,图片格式可以为:jpg, jpeg, png, gif。
(4)本接口仅提供给hosting应用使用。

2 接口调用说明

2.1 URL

http://[域名]/v3/photo/save_pic

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
pic 必须 string 注意计算签名参数sig时,不要包含本参数。

要上传的图片的文件路径以及图片的内容(在发送请求时,图片内容以二进制数据流的形式发送,见下面的请求示例)。
图片仅支持jpg, jpeg, png, gif格式(若为gif格式,会失去动画效果, 只保留一帧),图片大小小于2M。

pic_size string 图片上传后返回的url中对应的图片尺寸。

0:返回原图;
500:返回长边为500px的图片;
316:返回长边为316px的图片。
如果不传该参数,则默认为0,即返回原图。
说明
图片上传后,平台会对图片进行处理,分别存储以下尺寸的图片:
(1)原图:不对图片进行处理,保持原图的尺寸;
(2)长边为500px的图片:将图片的较长的边压缩为500px,较短的边按比例进行压缩;
(3)长边为316px的图片:将图片的较长的边压缩为316px,较短的边按比例进行压缩。

2.6 请求示例

注意POST请求中必须使用multipart/form-data协议(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

POST /v3/photo/save_pic HTTP/1.1

Accept-Language: zh-cn

Content-Type: multipart/form-data; boundary=c9152e99a2d6487fb0bfd02adec3aa16


//…此处省去部分HTTP头部


--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="openid"

*******************************

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="openkey"

*******************************

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="appid"

*****

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="sig"

*******************************

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="pf"

qzone

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="format"

json

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="userip"

112.90.139.30

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="pic_size"

0

--c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name="pic"; filename="home\pic\test.png"

Content-Type: image/x-png

//…此处省去图片二进制数据流

--c9152e99a2d6487fb0bfd02adec3aa16--


2.7 返回参数说明

参数名称 描述
ret 返回码。

私有返回码如下:
2001:要获取的头像不存在。
公共返回码详见:公共返回码说明#OpenAPI V3.0 返回码

msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

url 图片上传后返回图片对应的url。
file_id 图片上传后分配给图片的唯一ID。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,   
  "is_lost":0,   
  "url":"http://p.qpic.cn/open3rd/10883/5BA61AE/0",
  "file_id": "d66cb73e09f76ea6e01238010c8a225d"
} 

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
  "ret":1002,
  "msg":"请先登录" 
}

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部