分享到 :

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

<?xml version="1.0" encoding="UTF-8"?>
<data>
   <album>
      <albumid>2c9abe21-4f31-4c05-82a1-892875642f97</albumid>
      <classid>0</classid>
      <createtime>1201268600</createtime>
      <desc><![CDATA[ ]]></desc>
      <name><![CDATA[贴图相册]]></name>
      <coverurl>http://o123.photo.store.qq.com/psb?/V126ZXhr2klzSo</coverurl>
      <picnum>85</picnum>
   </album>
   <albumnum>1</albumnum>
   <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>

 

返回顶部