分享到 :

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 正确返回示例

Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"",
"total":1,
"photos":[
  {
    "sloc":"MwyA32lYa02utR6wHH*xWsiPsc16F3AAAA!!",
    "lloc":"M3GQ.eyg6UqQlcu1XZ5GlsANPM96*W4AAA!!",
    "name":"西湖 ",
    "desc":" ",
    "updated_time":1306381479,
    "uploaded_time":"2011-05-26 11:44:39",
    "small_url":"http://a206.photo.store.qq.com/psu?/73265682-4549-43be-8f08-1fddd4813668/
	 Xv7KjsOadqdULfxTIHdIiUd.3.KAlzHZAsqMLoF17Ew!/a/YY.xzXoXcAAAYg08z3r9bgAAbzCwzXoEcQAA",
    "large_image":{
        "height":503,
        "width":670,
        "url":"http://b206.photo.store.qq.com/psu?/73265682-4549-43be-8f08-1fddd4813668/
		 Xv7KjsOadqdULfxTIHdIiUd.3.KAlzHZAsqMLoF17Ew!/b/YY.xzXoXcAAAYg08z3r9bgAAbzCwzXoEcQAA"
            }
   }
 ]
}

 

1.9 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":100029,
"msg":"http protocol is illegal"
}
返回顶部