小宇宙 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" }

返回引數說明:

引數名引數型別引數說明引數示例
codeint返回狀態碼0 為成功,其它值為失敗
msgstring返回資訊返回錯誤時的說明
typestring登入方式qq
urlstring登入跳轉地址https://graph.qq.com/oauth2.0/XXXXXXXXXX
qrcodestring登入掃碼地址此地址僅微信和支付寶返回

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"
}

返回引數說明:

引數名引數型別引數說明引數示例
codeint返回狀態碼0 為成功,2 為未完成登入,其它值為失敗
msgstring返回資訊返回錯誤時的說明
typestring登入方式qq
social_uidstring第三方登入 UIDAD3F5033279C8187CBCBB29235D5F827
access_tokenstring第三方登入 token89DC9691E274D6B596FFCB8D43368234
faceimgstring使用者頭像https://thirdqq.qlogo.cn/g?……
nicknamestring使用者暱稱莫蒂奇
genderstring使用者性別
locationstring使用者所在地XXXXX 市 (僅限支付寶/微信返回)
ipstring使用者登入 IP1.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"
}

返回引數說明:

引數名引數型別引數說明引數示例
codeint返回狀態碼0 為成功,其它值為失敗
msgstring返回資訊返回錯誤時的說明
typestring登入方式qq
social_uidstring第三方登入 UIDAD3F5033279C8187CBCBB29235D5F827
access_tokenstring第三方登入 token89DC9691E274D6B596FFCB8D43368234
faceimgstring使用者頭像https://thirdqq.qlogo.cn/g?……
nicknamestring使用者暱稱modiq
genderstring使用者性別
locationstring使用者所在地XXXXX 市 (僅限支付寶/微信返回)
ipstring使用者登入 IP1.12.3.40

WPXYZ SDK 下載

版本:1.0