開發文件 – 蛋叮域名 DemoDNS

蛋叮 DemoDNS 介紹

聚合登入，就是利用使用者在第三方平臺上已有的賬號來快速完成自己應用的登入流程。

這裡的第三方平臺，是指QQ、微信、微博、百度等平臺。透過本站的聚合登入介面，你的網站可以登入獲取相應的使用者資訊和授權資訊，例如uid、token、使用者暱稱、頭像等。本站的聚合登入完全符合OAuth2.0身份鑑權機制。

介面協議規則

傳輸方式：HTTP
資料格式：JSON
字元編碼：UTF-8

蛋叮 DemoDNS 流程

Step1：獲取跳轉登入地址

請求URL：

https://app.demodns.com/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登入方式}&redirect_uri={返回地址}

其中登入方式對應值：

對應值	登入方式名稱

返回格式：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX"
}

返回引數說明：

引數名	引數型別	引數說明	引數示例
code	int	返回狀態碼	0為成功，其它值為失敗
msg	string	返回資訊	返回錯誤時的說明
type	string	登入方式	qq
url	string	登入跳轉地址	https://graph.qq.com/oauth2.0/XXXXXXXXXX
qrcode	string	登入掃碼地址	此地址僅微信和支付寶返回

Step2：跳轉到登入地址
登入地址為上一步返回的url的值。

Step3：登入成功會自動跳轉到指定的redirect_uri，並跟上Authorization Code

例如回撥地址是：www.qq.com/my.php，則會跳轉到：

http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******

Step4：透過Authorization Code獲取使用者資訊

請求URL：

https://app.demodns.com/connect.php?act=callback&appid={appid}&appkey={appkey}&type={登入方式}&code={code}

返回格式：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=3WrWp3peBxlW4MFxDgDJEQ&s=100&t=1596856919",
  "nickname": "莫蒂奇",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.12.3.40"
}

返回引數說明：

引數名	引數型別	引數說明	引數示例
code	int	返回狀態碼	0為成功，2為未完成登入，其它值為失敗
msg	string	返回資訊	返回錯誤時的說明
type	string	登入方式	qq
social_uid	string	第三方登入UID	AD3F5033279C8187CBCBB29235D5F827
access_token	string	第三方登入token	89DC9691E274D6B596FFCB8D43368234
faceimg	string	使用者頭像	https://thirdqq.qlogo.cn/g?……
nickname	string	使用者暱稱	莫蒂奇
gender	string	使用者性別	男
location	string	使用者所在地	XXXXX市(僅限支付寶/微信返回)
ip	string	使用者登入IP	1.12.3.40

獲取使用者資訊介面

在使用者登入後的任意時間，可以請求以下介面再次查詢使用者的詳細資訊。

請求URL：

https://app.demodns.com/connect.php?act=query&appid={appid}&appkey={appkey}&type={登入方式}&social_uid={social_uid}

social_uid就是使用者的第三方登入UID，用於識別使用者的唯一欄位。

返回格式：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "nickname": "莫蒂奇",
  "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.12.3.40"
}

返回引數說明：

引數名	引數型別	引數說明	引數示例
code	int	返回狀態碼	0為成功，其它值為失敗
msg	string	返回資訊	返回錯誤時的說明
type	string	登入方式	qq
social_uid	string	第三方登入UID	AD3F5033279C8187CBCBB29235D5F827
access_token	string	第三方登入token	89DC9691E274D6B596FFCB8D43368234
faceimg	string	使用者頭像	https://thirdqq.qlogo.cn/g?……
nickname	string	使用者暱稱	modiq
gender	string	使用者性別	男
location	string	使用者所在地	XXXXX市(僅限支付寶/微信返回)
ip	string	使用者登入IP	1.12.3.40

DemoDNS SDK 下載

版本：1.0

點選下載