web-ios API

[gugugupan]

括号中未写参量均使用GET请求，并且所有请求后缀请加上 .json 如 http://domain_url/users/1/fetch_music.json?env=1

随机获取标签：
http://domain_url/tags/fetch
返回：[ {tag1} , {tag2} , {tag3} , {tag4} , {tag5} , {tag6} ]
参数：无
例子：
[{"name":"indie folk","id":75,"updated_at":"2013-03-07T16:14:38Z","created_at":"2013-03-07T16:14:38Z"},{"name":"love at first listen","id":11,"updated_at":"2013-03-07T16:14:32Z","created_at":"2013-03-07T16:14:32Z"},{"name":"singer-songwriter","id":4,"updated_at":"2013-03-07T16:14:32Z","created_at":"2013-03-07T16:14:32Z"},{"name":"easy listening","id":43,"updated_at":"2013-03-07T16:14:35Z","created_at":"2013-03-07T16:14:35Z"},{"name":"pop punk","id":60,"updated_at":"2013-03-07T16:14:37Z","created_at":"2013-03-07T16:14:37Z"},{"name":"dream pop","id":70,"updated_at":"2013-03-07T16:14:38Z","created_at":"2013-03-07T16:14:38Z"}]

用户设定标签：(POST)
http://domain_url/users/:id/set_tag
返回：无
参数：tag=tag1,tag2,tag3 tag名字用半角逗号分开，最后不要逗号
例子：http://domain_url/users/:id/set_tag?tag=pop,rock

新建用户、获取某个用户信息：
http://domain_url/users/create
http://domain_url/users/:id/fetch
返回：{user}
参数：无
例子：{"login_count":0,"id":1,"play_count":0,"updated_at":"2013-03-07T07:51:01Z","created_at":"2013-03-07T07:51:01Z"}

获取特定id音乐信息：
http://domain_url/musics/:id/fetch
返回：{music}
参数：无
例子：{"name":"We Are Never Ever Getting Back Together\n","artist":"Taylor Swift\n","id":1,"played_times":0,"url":"http://10.141.247.17:3001/music/1.mp3","updated_at":"2013-03-07T06:57:49Z","created_at":"2013-03-07T06:57:49Z"}

反馈用户评分：(POST)
http://domain_url/users/:id/feedback
返回：无
参数：music_id=1 反馈音乐编号
score=0.3 反馈评价(实数介于[0,1])

获取推荐音乐：
http://domain_url/users/:id/fetch_music
返回：{music}
参数：env=1,2,3,4 所处环境（户外、运动、学习、休息）

==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============
==============OLD设定 下面全部无视===============

web-ios api

music struct in json
music : {
id : 1937743 ,
url : "http://xxx.ccc.vvv.mp3",
name : "ffff" ,
artist : "aaa" ,
duration : 360 , // in second
score : 0.55 // score in server
}

http://DOMAIN_PATH/login
HTTP-METHOD : POST
POST parameter :
username
password - by MD5
return : {
result : 0 (success) or 1 (failure) ,
token : user token
pwd : token password
}

http://DOMAIN_PATH/register
HTTP-METHOD : POST
POST parameter :
username
password
return : {
result : 0 (success) or 1 (failure)
(if success)
token :
pwd :
(endif)
}

http://DOMAIN_PATH/touch
HTTP-METHOD : POST
POST parameter :
token
pwd
environment
limit
(if isn't first touch)
musicid
score
(endif)
return : {
result : 0 or 1 (if token fail)
(if success)
music : {
[music_struct]
}
}