開發文件 - 文派小宇宙 WP XYZ

小宇宙 WPXYZ 介紹

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

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

介面協議規則

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

小宇宙 WPXYZ 流程

Step1：獲取跳轉登入地址

請求 URL：

https://app.wpxyz.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，則會跳轉到：

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

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

請求 URL：

https://app.wpxyz.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.wpxyz.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

WPXYZ SDK 下載

版本：1.0

點選下載