分享到 :

list_album

特别声明

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

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

1 接口说明

获取登录用户的相册列表。

1.1 URL

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

1.2 格式

JSON,XML

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)通用参数

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

(2)私有参数

format: 定义API返回的数据格式。

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

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

1.5 请求示例

以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

https://graph.qq.com/photo/list_album ?

access_token=*************&

oauth_consumer_key=123456&

openid=****************&

format=xml

1.6 返回参数说明

ret: 返回码

albumid: 相册ID

classid: 相册分类ID

createtime: 相册创建时间

desc: 相册描述

name: 相册名称

coverurl: 相册封面照片地址

picnum: 照片数

albumnum: 相册总数

msg: 错误消息

1.7 返回码说明

0: 正确返回

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

1.8 正确返回示例

XML示例:

1.9 错误返回示例

XML示例:

 

返回顶部