分享到 :

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>

 

 

返回顶部