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>

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部