| 第1行： | 第1行： | ||
{{api_desc_v2| | {{api_desc_v2| | ||
uri=proxy/darwin/graph/music/song/add| | uri=proxy/darwin/graph/music/song/add| | ||
| − | desc= | + | desc=添加音乐对象| |
httpMethod=POST| | httpMethod=POST| | ||
needAuth=是| | needAuth=是| | ||
2014年11月12日 (三) 19:42的版本
proxy/darwin/graph/music/song/add
添加音乐对象
URL
https://api.weibo.com/2/proxy/darwin/graph/music/song/add.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| music_id | true | string | 音乐对象id |
| name | true | string | 歌曲名称 |
| about | true | string | 对象描述信息 |
| singer | true | string | 演唱者 |
| publish_time | true | timestamp | 发行时间 格式为YYYY-MM-DD HH:MM:SS,如2014-10-24 10:5:5 |
| timeformusic | true | int | 音乐播放时长,单位秒 |
| writer | false | string | 作词人 |
| composer | false | string | 作曲人 |
| genre | false | string | 音乐体裁 |
| album | false | string | 专辑 |
| language | false | string | 语言 |
| music_format | false | string | 音频格式 |
| last_modify | false | timestamp | 最后修改时间，格式为YYYY-MM-DD HH:MM:SS,如2014-10-24 10:5:5,默认为1900-01-01 00:00:00 |
| arrangement | false | string | 编曲 |
| producer | false | string | 制作人 |
| lyric | false | string | 歌词 |
| url | false | string | url地址信息,要求经过urlencode,否则会因为串中含有&被截断 |
注意事项
- 更新数据的类型必须与元数据中记录的类型一致
- 在 JSON 中使用自1970-01-01以来的毫秒数表示时间戳类型字段
调用样例及调试工具
返回结果
JSON示例
{
"result": true
}
//失败返回
{
"request": "/2/darwin/graph/music/song/add.json",
"error_code": "25200",
"error": "error message."
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
{{{resultDes}}}
其他
无
相关问题
到 帮助中心 查看更多问题或提问
