返回顶部

upload_pic

特别声明

出于信息安全的考虑,本接口仅对可信赖的合作网站开放。

已经成功接入“QQ登录”的网站需提交申请以获取访问OpenAPI的权限。

 

1 接口说明

登录用户上传照片,支持单张上传和批量上传。

1.1 URL

OAuth2.0协议: https://graph.qq.com/photo/upload_pic

1.2 格式

JSON,XML

1.3 HTTP请求方式

POST

1.4 输入参数说明


计算签名时参数名及其值不做URL编码,HTTP请求包的 body内容也不做URL编码。

以下参数以POST方式提交表单。

(1)通用参数

-OAuth2.0协议必须传入的通用参数,详见这里

(2)私有参数

参数名称 是否必须 类型 描述
photodesc string 照片描述,注意照片描述不能超过200个字符。
title string 照片的命名,必须以.jpg, .gif, .png, .jpeg, .bmp此类后缀结尾。
albumid string 相册id。可不填,不填时则根据“mobile”标识选择默认上传的相册。
mobile int 标志位,0表示PC,1表示手机。用于当不传相册id时(即albumid为空时)控制是否传到手机相册。 

(1)如果传1,则当albumid为空时,图片会上传到手机相册;

(2)如果不传或传0,则当albumid为空时,图片会上传到贴图相册;

x string 照片拍摄时的地理位置的经度。请使用原始数据(纯经纬度,0-360)。
y string 照片拍摄时的地理位置的纬度。请使用原始数据(纯经纬度,0-360)。
format string 定义API返回的数据格式。 

取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。

注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。

picture 必须 string 上传照片的文件名以及图片的内容(在发送请求时,图片内容以二进制数据流的形式发送,见下面的请求示例),注意照片名称不能超过30个字符。
needfeed int 标识上传照片时是否要发feed(0:不发feed; 1:发feed)。 

如果不填则默认为发feed。

successnum int 批量上传照片时,已成功上传的张数,指明上传完成情况。 

单张上传时可以不填,不填则默认为0。

picnum int 批量上传照片的总张数,如果不填则默认为1。 

-如果picnum=1,为单张上传,发送单张上传feed;

-如果picnum>1,为批量上传,发送批量上传feed。

批量上传方式:picnum为一次上传照片的张数,successnum初始值为0,每调用一次照片上传接口后递增其值。

信息中心中的feed表现形式:批量上传时最新的7张在feed中展示。其中最新上传的一张图片展示为大图,剩下的六张按从新到旧的顺序展示为小图,其他图片不在feed中展示。

1.5 请求示例

以POST方式提交表单(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

POST /photo/upload_pic HTTP/1.1

Accept-Language: zh-cn

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

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

 

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”access_token”

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

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”oauth_consumer_key”

000001

–c9152e99a2d6487fb0bfd02adec3aa16

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

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

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”photodesc”

It’s me!

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”title”

me.jpg

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”albumid”

0001

–c9152e99a2d6487fb0bfd02adec3aa16

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

xml

–c9152e99a2d6487fb0bfd02adec3aa16

Content-Disposition: form-data; name=”picture”; filename=”C:Documents and Settings桌面apple.png”

Content-Type: image/x-png

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

–c9152e99a2d6487fb0bfd02adec3aa16–

1.6 返回参数说明

ret: 返回码

albumid: 相册ID

lloc: 大图ID

sloc: 小图ID

large_url: 大图地址

small_url: 小图地址

height: 图片高(单位:像素)

width: 图片宽(单位:像素)

msg: 错误消息

 

1.7 返回码说明

0: 正确返回

其它: 失败。错误码说明详见:公共返回码说明

1.8 正确返回示例

XML示例:

1.9 错误返回示例

XML示例: