返回顶部

list_photo

特别声明

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

 

1 接口说明

获取登录用户的照片列表。

1.1 URL

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

OAuth1.0协议: http://openapi.qzone.qq.com/photo/list_photo

1.2 格式

json,xml

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)通用参数

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

(2)私有参数

参数名称 是否必须 类型 描述
format string 定义API返回的数据格式。
取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 

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

albumid 必须 string 表示要获取的照片列表所在的相册ID。

1.5 请求示例

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

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

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

oauth_consumer_key=123456&

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

format=json&

albumid=73265682-4549-43be-8f08-1fddd4814775

 

1.6 返回参数说明

参数名称 描述
ret 返回码,正常为0
msg 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码
total 此次获取的照片总数
photos 获取的照片详细信息集合,照片的详细信息如下:

参数名称 描述
sloc 照片的小图ID。照片采用双ID结构,根据任一ID都可获得照片信息
lloc 照片的大图ID。照片采用双ID结构,根据任一ID都可获得照片信息
name 照片的标题
desc 照片的描述信息
updated_time 照片上次被修改的时间
uploaded_time 照片的上传时间
small_url 照片的小图的url
large_image 照片的大图的详细信息集合,大图的详细信息如下:

height :照片的高度。单位:像素

width :照片的高度。单位:像素

url :照片的url

1.7 返回码说明

0: 正确返回。

其它: 失败。

OpenAPI公共错误码说明详见:公共返回码

 

1.8 正确返回示例

 

1.9 错误返回示例

Content-type: text/html; charset=utf-8

{

“ret”:100029,

“msg”:”http protocol is illegal”

}