创建照片专辑

接口说明

创建照片专辑

访问权限

需设置 scope=create_album 才能访问。详细说明请参考接口访问权限说明

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/album/create.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/album/create.(json|xml)
session key方式:https://api.kaixin001.com/album/create.(json|xml)

支持格式

XML/JSON

是否使用HTTPS连接

OAuth1.0a access token方式:否
OAuth2.0 access token方式:是
session key方式:是

HTTP请求方式

POST

是否需要登录

TRUE

注意事项

若参数title缺失, 返回错误提示: album_title_absent。
若参数oauth_token缺失或者错误,返回错误提示:oauth_invalid_access。

调用示例

请求参数说明

API参数

字段是否必选说明
titleTRUE照片专辑标题
privacyFALSE照片专辑隐私设置(0:任何人可见, 1:仅好友可见, 2:凭密码, 3:隐藏),
默认为0任何人可见
password FALSE照片专辑密码(privacy为2时必填)
categoryFALSE照片专辑分类(0:空, 1:美女, 2:帅哥, 3:宠物, 4:旅游, 5:美食, 6:家居, 7:街拍,
8:时尚,9:风景, 10:奇趣)
allow_repasteFALSE是否允许转贴,仅在privacy为1时有效,默认为允许转帖。其他情况下该参数无效
locationFALSE照片专辑拍摄地点
descriptionFALSE照片专辑描述

OAuth1.0验证参数

oauth_token:授权的access token。
oauth_consumer_key:应用的App Key。
oauth_signature_method:签名方法,暂只支持HMAC-SHA1。
oauth_signature:签名值,密钥为oauth_comsumer_secret和oauth_token_secret以&作为分隔符拼起来。
oauth_timestamp:时间戳, 其值是距1970 00:00:00 GMT的秒数。
oauth_nonce:单次值,随机生成的32位字符串,防止重放攻击(每次请求必须不同)。
oauth_version:(可选) 版本号,如果有必须为 1.0。

OAuth2.0验证参数

access_token:授权的access token。

调试工具地址

返回结果示例

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<albumid>4758</albumid>

JSON示例

{
    "albumid": "4758"
}

返回字段说明

字段说明类型
albumid创建成功的照片专辑IDstring

错误代码释义