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网页使用）：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
  <HEAD>
     <TITLE> New Document </TITLE>
     <META NAME="Generator" CONTENT="EditPlus">
     <META NAME="Author" CONTENT="">
     <META NAME="Keywords" CONTENT="">
     <META NAME="Description" CONTENT="">
  </HEAD>
  <BODY>
     <form action="https://graph.qq.com/photo/add_album" method="post">
        access token<input value="********..." name="access_token" /><br>
        appid<input value="222222" name="oauth_consumer_key" /><br>
        openid<input value="="********" " name="openid" /><br>
        albumname<input value="my family" name="albumname" /><br>
        albumdesc<input value="真不错" name="albumdesc" /><br><br>
        priv<input value="1" name="priv" /><br>
        <input type="submit" value="创建相册" />
     </form>
  </BODY>
</HTML>

1.6 返回参数说明

ret: 返回码
albumid: 相册ID
classid: 相册分类ID
createtime: 相册创建时间
desc: 相册描述
name: 相册名称
priv: 相册权限
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><![travel]]></name>
      <priv>85</priv>
   </album>
   <msg><![CDATA[ ]]></msg>
   <ret>0</ret>
</data>

1.9 错误返回示例