Skip to content
当前页

用户接口


用于对接自有系统,可实现同步当前用户到SaasSNS系统。

请求URL
  • https://域名/addons/saassns/saas_api/login
请求方式
  • POST
参数
参数名必选类型说明
api_keystringApi密钥(后台获取)
usernamestring用户名手机号必传一种
mobilestring用户名手机号必传一种
query_modestring可选值:all(默认),username(仅通过用户名查找用户),mobile(仅通过手机号查找用户)
auto_regint是否自动注册,1:是,0:否
passwordstring初始密码(auto_reg为1时必填)
nicknamestring初始昵称(auto_reg为1时可选填)
avatarstring初始头像(auto_reg为1时可选填)
tagsstring用户标签,以英文,隔开(auto_reg为1时可选填)
medalsstring用户勋章,以英文,隔开(auto_reg为1时可选填)
返回示例
{
    "code": 1,
    "msg": "登录成功",
    "time": "1666740098",
    "data": {
        "token": "117aa2df-2b8c-4ccf-8ba3-308e0e0cd9dc",
        "user_id": 291112135,
        "createtime": 1666740098,
        "expiretime": 1669332098,
        "expires_in": 2592000,
        "is_reg": 0,
        "nickname": "aaaaaQ4eu0",
        "username": "used122",
        "mobile": "13222222211",
        "group_id": 1
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
返回参数说明
参数名类型说明
tokenstring用户登录token
user_idint系统内用户ID
createtimeinttoken生成时间
expiretimeinttoken过期时间
expires_ininttoken有效时长
is_regint0为登录,1为自动注册成功并登录
nicknamestring登录账号昵称
usernamestring登录账号用户名
mobilestring登录账号手机号
group_idint登录账号用户组
接口描述

必传手机号/用户名其一,当auto_reg为0时,如果查询不到用户则返回无用户,当auto_reg为1时,则根据信息注册初始用户账号,此时传入的参数均为初始注册信息 调用完成后返回token,可拼接到H5或电脑端首页跳转自动登录账号。

如https://***.saassns.com?token=xxx

如果是正式版,则此链接兼容电脑端及H5端

如果是免费版,则使用

https://***.saassns.com/h5/#/?token=xxx