協力廠商應用在接入嘟哩平臺時,往往需要集成嘟哩的用戶系統、應用通知等能力,而在使用這些能力之前,通常會對用戶的合法性進行校驗,此時就需要做“單點登錄”驗證。
現時嘟哩實現單點登錄的機制如下:
1.嘟哩用戶端打開協力廠商應用時,協力廠商應用可以通過url上獲得identify_token;
2.協力廠商應用後端服務根據用戶端提交的identify_token參數,請求嘟哩介面驗證的合法性;
介面說明
•此介面獨立於嘟哩服務其他SDK介面,不需要遵守全域約定的加解密管道及數據格式。
•嘟哩用戶端攜帶identify_token到目標服務,目標服務將token作為提交內容調用嘟哩服務的單點登錄介面確認用戶身份
請求說明
GET請求URL:http://[SERVER:9022]/v1/identify?token=$identify_token
請求參數
參數 | 類型 | 必須 | 說明 |
token | string | 是 | 身份认证的token |
在嘟哩管理後臺—>企業應用—>應用管理—>主頁型應用配寘的URL中使用範本參數[TOKEN],嘟哩用戶端在請求時會自動將該範本參數替換成token
返回結果示例
該介面響應數據無加密
結果欄位說明
欄位 | 類型 | 說明 |
code | ngt | 介面調用狀態說明 |
msg | string | 狀態碼相關的資訊描述 |
create_time | date | 結果返回時間,格式:2022-08-13 19:55:55 |
data | 認證成功後返回的相關帳號資訊 | |
account | string | 帳號 |
nick_name | string | 昵稱 |
phone | string | 手機號碼 |
string | 郵箱 | |
狀態碼說明
狀態碼(code) | 說明 |
100010 | token已失效 |