upload_pic

特别声明

出于信息安全的考虑,本接口仅对可信赖的合作网站开放。
已经成功接入“QQ登录”的网站需提交申请以获取访问OpenAPI的权限。


目录

1 接口说明

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

1.1 URL

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.

腾讯公司 版权所有

有问必答 返回顶部