開發文檔 - 文派小宇宙 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

點擊下載