| 第25行： | 第25行： | ||
{{api_args|url| false| string| url地址信息,要求经过urlencode,否则会因为串中含有&被截断}}| | {{api_args|url| false| string| url地址信息,要求经过urlencode,否则会因为串中含有&被截断}}| | ||
apiToolPara=key1=status&value1=微博来自API测试工具| | apiToolPara=key1=status&value1=微博来自API测试工具| | ||
| − | + | ||
result= | result= | ||
<pre> | <pre> | ||
2014年11月12日 (三) 15:22的版本
proxy/darwin/graph/music/song/add.json
歌曲object数据入库
URL
https://api.weibo.com/2/proxy/darwin/graph/music/song/add.json.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."
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| created_at | string | 微博创建时间 |
| id | int64 | 微博ID |
| mid | int64 | 微博MID |
| idstr | string | 字符串型的微博ID |
| text | string | 微博信息内容 |
| source | string | 微博来源 |
| favorited | boolean | 是否已收藏，true：是，false：否 |
| truncated | boolean | 是否被截断，true：是，false：否 |
| in_reply_to_status_id | string | （暂未支持）回复ID |
| in_reply_to_user_id | string | （暂未支持）回复人UID |
| in_reply_to_screen_name | string | （暂未支持）回复人昵称 |
| thumbnail_pic | string | 缩略图片地址，没有时不返回此字段 |
| bmiddle_pic | string | 中等尺寸图片地址，没有时不返回此字段 |
| original_pic | string | 原始图片地址，没有时不返回此字段 |
| geo | object | 地理信息字段 详细 |
| user | object | 微博作者的用户信息字段 详细 |
| retweeted_status | object | 被转发的原微博信息字段，当该微博为转发微博时返回 详细 |
| reposts_count | int | 转发数 |
| comments_count | int | 评论数 |
| attitudes_count | int | 表态数 |
| mlevel | int | 暂未支持 |
| visible | object | 微博的可见性及指定可见分组信息。该object中type取值，0：普通微博，1：私密微博，3：指定分组微博，4：密友微博；list_id为分组的组号 |
| pic_ids | object | 微博配图ID。多图时返回多图ID，用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID，即可得到多个图片url。 |
| ad | object array | 微博流内的推广微博ID |
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
