嘟哩开放平台
简体中文
繁體中文
English
快速开始 开放接口 嘟哩官网
模板

[单点登录]


第三方应用在接入 嘟哩 平台时,往往需要集成 嘟哩 的用户系统、应用通知等能力,而在使用这些能力之前,通常会对用户的合法性进行校验,此时就需要做“单点登录”验证。

目前 嘟哩 实现单点登录的机制如下:

  1. 嘟哩客户端打开第三方应用时,第三方应用可以通过url上获得identify_token;
  2. 第三方应用后端服务根据客户端提交的identify_token参数,请求嘟哩接口验证的合法性;

接口说明

  • 此接口独立于嘟哩服务其他SDK接口,不需要遵守全局约定的加解密方式及数据格式。
  • 嘟哩客户端携带identify_token到目标服务,目标服务将token作为提交内容调用嘟哩服务的单点登录接口确认用户身份

身份验证接口

请求说明

GET请求URL:http://[SERVER:9022]/v1/identify?token=$identify_token

[SERVER:9022]指连接的服务器地址,如:http://duliduli.com:8090/v1/identify


请求参数

参数

类型

必须

说明

token

string

身份认证的token

在嘟哩管理后台—>企业应用—>应用管理—>主页型应用配置的URL中使用模板参数[TOKEN],嘟哩客户端在请求时会自动将该模板参数替换成token


返回结果示例

{
"code": 0,
"msg": "ok",
"create_time":"2022-08-13 19:55:55",
"data": {
"account": "$account",
"nickName":"$nickName",
"phone":"$phone",
"email":"$email"
}
}

该接口响应数据无加密

结果字段说明

字段

类型

说明

code

ngt

接口调用状态说明

msg

string

状态码相关的信息描述

create_time

date

结果返回时间,格式 :2022-08-13 19:55:55

data


认证成功后返回的相关帐号信息

account

string

帐号

nick_name

string

昵称

phone

string

手机号码

email

string

邮箱


状态码说明

状态码(code)

说明

100010

token已失效