接口约定
- 使用https
- restful风格
- 用户端:https://{域名}/api/{接口版本号}/{resource}/{resource_id}/{sub_resource}/{sub_resource_id}/{action}?{query_string}
- 管理端:https://{域名}/admin/api/{接口版本号}/{resource}/{resource_id}/{sub_resource}/{sub_resource_id}/{action}?{query_string}
- 测试环境域名babieta.xivan.cn
- 正式环境域名待定
- 公共参数放在header,如userid,session_key,unionid,version等
- resource: users
接口
GET /users/{user_id}/baseinfo
name | cname | type | Description |
---|---|---|---|
用途 | 获取用户信息 | ||
方式 | GET | ||
版本号 | v1.0 |
请求数据:
query_string 参数
无
例
curl -i "https://babieta.xivan.cn/api/v1.0/users/xxx/baseinfo" -H "userid:oslC94mGqAAEz6iWhKhL9dEY5l3o" -H "token:25e8ba0469c6f1c0c6dcd4fe952b8e4e"
wx.request({
"url":"https://babieta.xivan.cn/api/v1.0/user/xxx/baseinfo",
"method":"GET",
"success": res =>{
console.log(res)
},
"data":{},
"dataType":"json",
"header": { "content-type":"application/x-www-form-urlencoded",
"openid": "oslC94mGqAAEz6iWhKhL9dEY5l3o", "token":"25e8ba0469c6f1c0c6dcd4fe952b8e4e"},
"complete": res => {
console.log(res)
}
})
返回数据:
name | cname | type | Description |
---|---|---|---|
code | int | 返回码 0成功 非0失败 | |
msg | string | 错误信息 | |
user_info | object | 用户信息对象 |
user_info
name | cname | type | Description |
---|---|---|---|
score | int | 积分 | |
level | int | 能力等级 | |
beyond_rate | int | 超越率 | |
new_flag | int | 1:新用户 2:老用户,判断首测依据 | |
stage | object | 阶段状态信息 |
object->stage
name | cname | type | Description |
---|---|---|---|
first | object | 当前阶段(pronunciation(已完成发音测试)/fluency(已完成流利度测试)/express(已完成表达测试) ), 未开始 (emtpy) | |
upgrade | object | 当前阶段(pronunciation(已完成发音测试)/fluency(已完成流利度测试)/express(已完成表达测试) ), 未开始(emtpy) |
object->first/upgrade
name | cname | type | Description |
---|---|---|---|
status | object | 当前阶段(pronunciation(已完成发音测试)/fluency(已完成流利度测试)/express(已完成表达测试) ), 未开始 (emtpy) | |
pay_status | object | 支付状态,1:已支付 0:未支付 |
例
{"msg": "", "code": 0, "user_info": {"score":199, "level":3, "beyond_rate ":96, "new_flag":2, "stage":{"first":{"status":"express", "pay_status":1}...}}}