上传照片

接口说明

上传照片到指定的照片专辑

访问权限

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

请求URL地址

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

支持格式

XML/JSON

是否使用HTTPS连接

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

HTTP请求方式

POST

是否需要登录

TRUE

注意事项

若参数albumid缺失, 返回错误提示:album_not_select
若参数pic缺失,返回错误提示:file_not_select
若参数oauth_token缺失或者错误,返回错误提示:oauth_invalid_access
如果照片上传失败,则返回错误提示:file_upload_failed

调用示例

请求参数说明

API参数

字段是否必选说明
albumidTrue照片专辑ID
titleFalse照片标题
sizeFalse返回照片的大小尺寸. 可选值:(mid, small, cover)
send_newsFalse是否发送动态. 可选值:(0:不发送动态, 1:发送动态)
picTrue要上传的照片文件
tagFalse照片的标签
locationFalse拍摄地点(目前仅在动态中显示,即send_news为1时可显示)
latFalse拍摄地点纬度 -90.0到+90.0,+表示北纬(目前暂不能显示)
lonFalse拍摄地点经度 -180.0到+180.0,+表示东经(目前暂不能显示)

OAuth1.0验证参数

oauth_token:授权的access token。
oauth_consumer_key:应用的API 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"?>
<photo>
    <albumid>4670</albumid>
    <uid>46765</uid>
    <pid>24537</pid>
    <src>http://p.kaixin001.com/privacy/photo/71/54/46765_279715464_cover.jpg</src>
</photo>

JSON示例

{
    "albumid": "4670",
    "uid": "46765",
    "pid": "24536",
    "src": "http:\/\/p.kaixin001.com\/privacy\/photo\/71/54/46765_279715464_cover.jpg"
}

返回结果字段说明

字段说明类型
uid 用户IDstring
albumid照片专辑IDstring
pid 照片IDstring
src 照片链接地址string

错误代码释义