分享到 :

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示例:

<?xml version="1.0" encoding="UTF-8"?>
<data>
   <albumid>1</albumid>
   <lloc>1</lloc>
   <sloc>1</soc>
   <large_url>http://o123.photo.store.qq.com/psb?/V126ZXhr2klzSo!!</large_url>
   <small_url>http://o123.photo.store.qq.com/psb?/V138ZXhr2klzSo!!</small_url>
   <height>750</height>
   <width>500</width>
   <msg><![CDATA[ ]]></msg>
   <ret>0</ret>
</data>

1.9 错误返回示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<data>
   <msg><![CDATA[输入的用户ID不正确。]]></msg>
   <ret>3902</ret>
</data>

 

 

返回顶部