返回顶部

add_album

特别声明

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

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

 

1 接口说明

登录用户创建相册。

:每个用户最多可创建10个相册。

1.1 URL

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

1.2 格式

JSON,XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

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

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

(2)私有参数

参数名称 是否必须 类型 描述
albumname 必须 string 相册名,不能超过30个字符。
albumdesc string 相册描述,不能超过200个字符。
priv string 相册权限,其取值含义为: 1=公开;3=只主人可见; 4=QQ好友可见; 5=问答加密。 

不传则相册默认为公开权限。

如果priv取值为5,即相册是问答加密的,则必须包含问题和答案两个参数:

-question: 问题,不能超过30个字符。

-answer: 答案,不能超过30个字符。

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

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

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

1.5 请求示例

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

access_token=****************

oauth_consumer_key=000001

openid=*******************************

format=xml

albumname=my family

albumdesc=very happy

priv=1

2. 对参数进行URL编码后拼接出的POST请求包:

POST /photo/add_album HTTP/1.1

//…此处省去部分HTTP头部

Host: graph.qq.com

Content-Length: 301

Content-Type: application/x-www-form-urlencoded

access_token=****************& oauth_consumer_key=000001& openid=*******************************& format=xml& albumname=my20%family& albumdesc=very20%happy& priv=1

3.下面是Post请求的HTML Form代码,开发者可以使用此表单来测试(供PC网页使用):

1.6 返回参数说明

ret: 返回码

albumid: 相册ID

classid: 相册分类ID

createtime: 相册创建时间

desc: 相册描述

name: 相册名称

priv: 相册权限

msg: 错误消息

1.7 返回码说明

0: 正确返回

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

1.8 正确返回示例

XML示例:

1.9 错误返回示例

XML示例:

1.10 代码示例

请从SDK下载页面下载PHP SDK,在photo文件夹下的add_album.php文件中找到相应的示例代码。