原生SDK登录态

先决条件 已开通SDK服务 已开通API服务

登录交互流程

登录接口

首先获取access_token

注意事项 此接口不支持更新 ,要更新用户信息,请看此接口

请求方式及url

请求方式:POST

接口地址:https://api.xiaoe-tech.com/xe.sdk.account.login/1.0.0

请求参数说明

参数名称 是否必选 类型 描述
app_user_id string APP用户id
access_token string 访问token
sdk_app_id string SDK应用id(SDK配置中的Client ID)
user_info array 用户信息,注册时可带

user_info数据

参数名称 是否必选 类型 描述
phone string 用户手机号码
avatar_url string 用户头像
nickname string 用户名
gender int 用户性别,0:未知;1:男性;2:女性
city string 用户城市
province string 用户省份
country string 用户国家
language string 用户语言,目前为空
union_id string 用户的微信union_id

备注:

  1. user_info 在注册时可选择性的传入用户信息,请在调用接口时将用户信息补充完整
  2. union_id和phone不可以同时传,可传递其中任意一个

示例

请求示例

{
  "app_user_id" : "xxxxx",
  "sdk_app_id" : "SEKeGinyTMTw",
  "access_token": "xxxx",
  "user_info": {
    "phone": "xxxx",
    "avatar_url": "url",
    "nickname": "xxx"
  }
}

响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "token_key": "xe_sdk_token",
        "token_value": "41eb1cebe1a5b33ee879f3012f796fbb",
        "user_id": "u_5bcaab6885e02_PCnohxzDUm",
        "sdk_user_id": "15991672530",
        "expires": 86400
    }
}

目前token_value有效期是1天, 可能变动, 代码里面最好不要写死了.

不能保证token有效期绝对是1天,因为小鹅通店铺有显示设备登陆数功能,很有可能该账号在别的终端登陆后(例如微信H5),会挤掉之前登陆的token,此时token不到1天也会失效,效果就是一进去会去到一个“登陆中”的页面,该页面会有SDK回调通知APP重新做登陆,重新调用account.login接口获取新token重新syncToken即可。

登出接口

请求方式及url

请求方式:POST

接口地址:https://api.xiaoe-tech.com/xe.sdk.account.logout/1.0.0

请求参数

参数名称 是否必选 类型 描述
app_id string 店铺app_id
sdk_app_id string SDK应用ID(对应SDK配置的Client ID)
token string 要登出的token(对应登录接口返回的用户token值)
access_token string 用户信息,注册时可带

响应参数

参数名称 类型 描述
code int 状态码,0表示成功,其他错误码见全局返回码
msg string 错误信息提示
data array 返回具体业务所需数据信息

示例

请求示例

{
  "app_id": "appdRx8JicQ9960",
  "sdk_app_id": "xxxx",
  "token": "xxx",
  "access_token": "xxxx"
}

响应示例

{
  "code": 0,
  "msg": "token 清理成功",
  "data": []
}

results matching ""

    No results matching ""