跳转到: 导航, 搜索
 
(未显示1个用户的2个中间版本)
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=proxy/darwin/graph/music/song/rating/add|
 
uri=proxy/darwin/graph/music/song/rating/add|
desc=关系数据入库-对歌曲评分|
+
desc=添加对音乐的评分|
 
httpMethod=POST|
 
httpMethod=POST|
 
needAuth=是|
 
needAuth=是|
第11行: 第11行:
 
{{api_args|music_id| true| string| 音乐对象id}}
 
{{api_args|music_id| true| string| 音乐对象id}}
 
{{api_args|rating_value| true| double| 打分值}}
 
{{api_args|rating_value| true| double| 打分值}}
{{api_args|rating_sacle| true| double| 评分上限}}
+
{{api_args|rating_scale| true| double| 评分上限}}
{{api_args|rating_text| false| sring| 打分评语}}
+
{{api_args|rating_text| false| string| 打分评语}}
 
{{api_args|create_time| true| timestamp| 动作创建时间,格式为YYYY-MM-DD HH:MM:SS,如2014-10-24 10:5:5}}|
 
{{api_args|create_time| true| timestamp| 动作创建时间,格式为YYYY-MM-DD HH:MM:SS,如2014-10-24 10:5:5}}|
 
apiToolPara=key1=status&value1=微博来自API测试工具|
 
apiToolPara=key1=status&value1=微博来自API测试工具|

2015年2月10日 (二) 14:13的最后版本

proxy/darwin/graph/music/song/rating/add

添加对音乐的评分

URL

https://api.weibo.com/2/proxy/darwin/graph/music/song/rating/add.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:普通接口
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
uid true string 用户的id,调用接口时的appkey可提供,用户的uid
iswbuid false Int 1为微博平台的uid,0则不是,默认为1
music_id true string 音乐对象id
rating_value true double 打分值
rating_scale true double 评分上限
rating_text false string 打分评语
create_time true timestamp 动作创建时间,格式为YYYY-MM-DD HH:MM:SS,如2014-10-24 10:5:5

注意事项

  • 更新数据的类型必须与元数据中记录的类型一致
  • 在 JSON 中使用自1970-01-01以来的毫秒数表示时间戳类型字段

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
  "result": true
}

//失败返回
{
  "request": "/2/darwin/graph/music/song/rating/add.json",
  "error_code": "25200",
  "error": "error message."
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

{{{resultDes}}}

其他

相关问题


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2015-02-10
api评价