rest示例(巴士电台接口API REST版)

最新推荐文章于 2022-04-30 10:02:36 发布

ebonyzhang

最新推荐文章于 2022-04-30 10:02:36 发布

阅读量4.9k

点赞数

分类专栏：接口,联调文章标签： rest api json url go

接口,联调专栏收录该内容

3 篇文章 1 订阅

订阅专栏

本文详细介绍了巴士电台API的REST版接口，包括账号管理、歌曲管理、频道列表及歌曲数据获取等核心功能，提供了登录、注册、找回密码、修改密码、用户名/昵称验证等操作方式，以及如何通过API获取频道列表、歌曲数据和用户收藏列表等信息。

摘要由CSDN通过智能技术生成

巴士电台接口API REST版

账号管理

歌曲管理

账号管理

方法类型：GET
调用地址：http://api.bus.fm/account/usermail/userpwd
参数说明：
- usermail:用户名/邮箱
- userpwd:用户密码
返回值：json对象，包含了登录状态，以及用户信息，如{"userinfo":[{"member_id":"88","member_mail":"demo@bus.fm","member_nickname":"demo"}]}

注册

方法类型： POST
调用地址：http://api.bus.fm/account/usermail/userpwd/nickname
参数说明：
- usermail:用户名/邮箱
- userpwd:用户密码
- nickname:用户昵称
返回值：状态码|状态说明，如1|注册成功,0|昵称被占用

找回密码

方法类型：GET
调用地址：http://api.bus.fm/password/usermail
参数说明：
- usermail:用户名/邮箱
返回值：状态码|状态说明，如1|密码已发至邮箱,0|昵称被占用

修改密码

方法类型：PUT
调用地址：http://api.bus.fm/password/userid/oldpwd/newpwd
参数说明：
- userid:用户名 (注：非邮箱)
- oldpwd:旧密码
- newpwd:新密码
返回值：状态码|状态说明，如1|修改成功,0|未知错误

用户名是否可用

方法类型：GET
调用地址：http://api.bus.fm/validate/usermail/type
参数说明：
- usermail:用户名/邮箱
- type: "username "
返回值：状态码或错误描述，0为可用，1为被占用，其他情况为错误描述

昵称是否可用

方法类型：GET
调用地址：get http://api.bus.fm/validate/name/type
参数说明：
- nickname:用户昵称
- type: "nickname"
返回值：状态码或错误描述，0为可用，1为被占用，其他情况为错误描述

歌曲管理

得到频道列表

方法类型：GET
调用地址：http://api.bus.fm/channel/
返回值：json数组

频道数据格式

        {"Channels": 
                [ 
                        {"cid":"1","cname":"白"}, 
                        {"cid":"2","cname":"灰"}, 
                        {"cid":"3","cname":"黑"}, 
                        {"cid":"4","cname":"红"}, 
                        {"cid":"99","cname":"私人频道"} 
                ] 
        }

根据频道返回歌曲数据

方法类型：GET
调用地址：http://api.bus.fm/music/channleid/appkey
参数说明：
- channelid:频道ID
- appkey:应用授权ID
返回值：json数组

歌曲json格式

{"Tracks": 
        [ 
                { 
                "songid":"1045", 
                "title":"If You Want To", 
                "url":"http://ftp.luoo.net/radio/radio93/02.mp3", 
                "artist":"Alligators", 
                "album":"Piggy and Cups", 
                "thumb":"http://www.luoo.net/wp-content/uploads/ds.jpg" 
                }, 
                { 
                "songid":"1503", 
                "title":"Let Go of the Dream", 
                "url":"http://ftp.luoo.net/radio/radio133/03.mp3", 
                "artist":"Hurricane No.1", 
                "albutm":"Hurricane No.1", 
                "thumb":"http://t.douban.com/lpic/s3832173.jpg" 
                } 
        ] 
}