1. 用户注册
POST:http://api.xdua.com/user
用户注册和添加接口包含两种字段:固定字段和额外字段。这么设计的原因是不同用户表会有不同的字段,这些字段是不可以预计的,而网关的设计不能无限制添加字段,所以要求额外的自定义字段放在extra里。
字段名 | 位置 | 字段类型 | 字段说明 | 可选 |
---|---|---|---|---|
apiv | head | string | api的版本,默认是1.0.0 | 可选 |
action | body | String | "signup"/"adduser" | 必选 |
by | body | String | "tel"/"mail" | 必选 |
ustr | body | String | 电话格式是+86-15810419011/邮箱格式是:jiaoshuai@ict.ac.cn | 必选 |
pwd | body | String | 密码,32位md5码 | 必选 |
vfcode | body | String | 验证码 | 可选 |
shop | body | String | 店铺 | 必选 |
role | body | String | 角色,默认"none" | 可选 |
tel | body | String | 电话,如果电话注册,ustr会覆盖tel字段. | 可选 |
body | String | 邮箱,如果邮箱注册,ustr会覆盖mail字段. | 可选 | |
extra | body | String | JSON,额外字段存放的地方 | 可选 |
tabx | body | String | 注册的新用户的extra字段存放在哪个用户表里 | 必选 |
- extra必须是合法的json字串,如果不是,服务端解析失败,会当作extra不存在.
- 如果是邮箱注册, ustr里存邮箱.
BrowserSDK调用代码
const dua = await lovearth({
APP_TOKEN:"eyJhbGciOiJSUzI1NiIsImtpZCI6ImI1MGIxZWZmZGMwMzVlMjg2OWI2YzQ1ZjMzYmRmNWQ3In0.eyJpYXQiOjE1NzE1NDg2NDYsIm5iZiI6MTU3MTU0ODY0NiwiaXNzIjoieGR1YS5jb20iLCJleHAiOjE4ODY5MDg2NDYsImF1ZCI6IkVJeGNQZHBUIiwic3ViIjoiQW5vTnltdVMiLCJqdGkiOiIxMjM0NTY3OCIsImNpcCI6IjE1OS4yMjYuMzkuMSIsImN1YSI6IkNhQ2xpZW50VWEiLCJkZXYiOiJVbml2ZXJzYWwiLCJvd24iOiJEdDVtdnJ0VSJ9.EuUqA9xBMxhc2pV-Th9g-TF-N6tYJsiAdCBW5H47dEDQuLWihm93Z4GxpgZxWII6ngTlmTCzhYwXB7n1Q9WxhN1cuZFfFzKvfmwss3t-9ekR4AlRxU8Oqho7A-bWZjqTuMzhp7xKFYtvltAIjfyyjFJ1x3MYp1mbHEhVoLkys7OzsT-hBMD10IDWJTWt9ddS04QnPjuFqby3_7--nqim_3oY_ZAGscmkOB1FSsV8XL9U_wF7nUfs6M-kSYmb_Io7G50exg8Jr6ibxzE_dkv6gAb52ahOx4zJw-aBVDPmcnRudFYuU0ekmKdMP0cB7h6uoP_9zsxblzoHpepLsg3Kcw"
})
api_name = "电话注册";
add_user_param={
api_action: "signup",
by : "tel",
ustr : "+86-18017050142",
pwd : "a906449d5769fa7361d7ecc6aa3f6d28",
vfcode : "您的短信验证码",
shop : "A3bdXNT3",
role : "none",
name : "你的名字",
sex : "F",
bday : "19860823",
mail : "jiaoshuai@ict.ac.cn",
avatar : "default.jpg",
extra :{
nickname:"我的昵称",
target:8000,
height:120,
weight:56,
},
tabx:"A3bdXNT3" // alters: "DefaultX"
}
res = await dua.addUser(add_user_param)
console.log(res);
if(res.error == 0){
console.log(api_name+"成功");
}else{
console.log(api_name+"失败 "+res.reason);
}
1.1. 返回数据
成功返回
{
apid: '9CDC73EE-2304-40B4-B419-4864204F92E8',
error: 0,
reason: 'success',
result: { id: '5QqitXe5' },
debug: []
}
字段名 | 字段类型 | 字段说明 |
---|---|---|
id | String | 用户的id:格式是8位数字母串 |
失败返回
{
"error": 1,
"result": {},
"reason": "失败的时候是具体原因"
}