開發者資料 · 意梵聚合登錄

<h2 style="text-align: center;">接口協議規則</h2> 傳輸方式：HTTP 數據格式：JSON 字符編碼：UTF-8 <h2 style="text-align: center;">聚合登錄流程</h2> <span data-v-380220c1="" class="float-right"> <i data-v-380220c1="" id="full-page" class="el-icon-full-screen"></i></span></div> <div data-v-380220c1="" id="doc-body"><div data-v-380220c1="" id="page_md_content" class="page_content_main"><div data-v-380220c1="" id="editor-md" class="main-editor markdown-body editormd-html-preview"><p><strong>Step1：獲取跳轉登錄地址</strong><br>請求URL：<br><code>https://www.ss349.cn/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登錄方式}&redirect_uri={返回地址}</code><br>其中登錄方式對應值： </p> <div style="width: 100%;overflow-x: auto;"><table> <thead> <tr> <th style="width: 393px;">對應值</th> <th style="width: 393px;">登錄方式名稱</th> </tr> </thead> <tbody> <tr style="background-color: rgb(255, 255, 255);"> <td>qq</td> <td>ＱＱ</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>wx</td> <td>微信</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>alipay</td> <td>支付寶</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>sina</td> <td>微博</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>baidu</td> <td>百度</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>huawei</td> <td>華為</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>xiaomi</td> <td>小米</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>google</td> <td>谷歌</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>microsoft</td> <td>微軟</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>facebook</td> <td>Facebook</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>dingtalk</td> <td>釘釘</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>gitee</td> <td>Gitee</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>github</td> <td>GitHub</td> </tr> </tbody> </table></div> <p>返回格式：</p> <p>{<br> “code”: 0,<br> “msg”: “succ”,<br> “type”: “qq”,<br> “url”: “<a href="https://graph.qq.com/oauth2.0/XXXXXXXXXX">https://graph.qq.com/oauth2.0/XXXXXXXXXX</a>“<br>}</p> <p>返回參數說明：</p> <div style="width: 100%;overflow-x: auto;"><table> <thead> <tr> <th style="width: 195px;">參數名</th> <th style="width: 195px;">參數類型</th> <th style="width: 195px;">參數說明</th> <th style="width: 195px;">參數示例</th> </tr> </thead> <tbody> <tr style="background-color: rgb(255, 255, 255);"> <td>code</td> <td>int</td> <td>返回狀態碼</td> <td>0為成功，其它值為失敗</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>msg</td> <td>string</td> <td>返回信息</td> <td>返回錯誤時的說明</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>type</td> <td>string</td> <td>登錄方式</td> <td>qq</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>url</td> <td>string</td> <td>登錄跳轉地址</td> <td><a href="https://graph.qq.com/oauth2.0/XXXXXXXXXX">https://graph.qq.com/oauth2.0/XXXXXXXXXX</a></td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>qrcode</td> <td>string</td> <td>登錄掃碼地址</td> <td>此地址僅微信和支付寶返回</td> </tr> </tbody> </table></div> <p><strong>Step2：跳轉到登錄地址</strong><br>登錄地址為上一步返回的url的值。 </p> <p><strong>Step3：登錄成功會自動跳轉到指定的redirect_uri，并跟上Authorization Code</strong><br>例如回調地址是：www.qq.com/my.php，則會跳轉到：<br><code>http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******</code> </p> <p><strong>Step4：通過Authorization Code獲取用戶信息</strong><br>請求URL： <code>https://www.ss349.cn/connect.php?act=callback&appid={appid}&appkey={appkey}&type={登錄方式}&code={code}</code><br>返回格式：</p> <p>{<br> “code”: 0,<br> “msg”: “succ”,<br> “type”: “qq”,<br> “access_token”: “89DC9691E274D6B596FFCB8D43368234”,<br> “social_uid”: “AD3F5033279C8187CBCBB29235D5F827”,<br> “faceimg”: “<a href="https://thirdqq.qlogo.cn/g?b=oidb&k=3WrWp3peBxlW4MFxDgDJEQ&s=100&t=1596856919">https://thirdqq.qlogo.cn/g?b=oidb&k=3WrWp3peBxlW4MFxDgDJEQ&s=100&t=1596856919</a>“,<br> “nickname”: “大白”,<br> “location”: “XXXXX市”,<br> “gender”: “男”,<br> “ip”: “1.12.3.40”<br>}</p> <p>返回參數說明：</p> <div style="width: 100%;overflow-x: auto;"><table> <thead> <tr> <th style="width: 195px;">參數名</th> <th style="width: 195px;">參數類型</th> <th style="width: 195px;">參數說明</th> <th style="width: 195px;">參數示例</th> </tr> </thead> <tbody> <tr style="background-color: rgb(255, 255, 255);"> <td>code</td> <td>int</td> <td>返回狀態碼</td> <td>0為成功，2為未完成登錄，其它值為失敗</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>msg</td> <td>string</td> <td>返回信息</td> <td>返回錯誤時的說明</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>type</td> <td>string</td> <td>登錄方式</td> <td>qq</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>social_uid</td> <td>string</td> <td>第三方登錄UID</td> <td>AD3F5033279C8187CBCBB29235D5F827</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>access_token</td> <td>string</td> <td>第三方登錄token</td> <td>89DC9691E274D6B596FFCB8D43368234</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>faceimg</td> <td>string</td> <td>用戶頭像</td> <td><a href="https://thirdqq.qlogo.cn/g?">https://thirdqq.qlogo.cn/g?</a>……</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>nickname</td> <td>string</td> <td>用戶昵稱</td> <td>消失的彩虹海</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>gender</td> <td>string</td> <td>用戶性別</td> <td>男</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>location</td> <td>string</td> <td>用戶所在地</td> <td>XXXXX市(僅限支付寶/微信返回)</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>ip</td> <td>string</td> <td>用戶登錄IP</td> <td>1.12.3.40</td> </tr> </tbody> </table></div> <p>獲取用戶信息接口</p> <p>在用戶登錄后的任意時間，可以請求以下接口再次查詢用戶的詳細信息。 </p> <p>請求URL： <code>https://www.ss349.cn/connect.php?act=query&appid={appid}&appkey={appkey}&type={登錄方式}&social_uid={social_uid}</code><br>social_uid就是用戶的第三方登錄UID，用于識別用戶的唯一字段。 </p> <p>返回格式：</p> <p>{<br> “code”: 0,<br> “msg”: “succ”,<br> “type”: “qq”,<br> “social_uid”: “AD3F5033279C8187CBCBB29235D5F827”,<br> “access_token”: “89DC9691E274D6B596FFCB8D43368234”,<br> “nickname”: “大白”,<br> “faceimg”: “<a href="https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185">https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185</a>“,<br> “location”: “XXXXX市”,<br> “gender”: “男”,<br> “ip”: “1.12.3.40”<br>}</p> <p>返回參數說明：</p> <div style="width: 100%;overflow-x: auto;"><table> <thead> <tr> <th style="width: 195px;">參數名</th> <th style="width: 195px;">參數類型</th> <th style="width: 195px;">參數說明</th> <th style="width: 195px;">參數示例</th> </tr> </thead> <tbody> <tr style="background-color: rgb(255, 255, 255);"> <td>code</td> <td>int</td> <td>返回狀態碼</td> <td>0為成功，其它值為失敗</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>msg</td> <td>string</td> <td>返回信息</td> <td>返回錯誤時的說明</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>type</td> <td>string</td> <td>登錄方式</td> <td>qq</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>social_uid</td> <td>string</td> <td>第三方登錄UID</td> <td>AD3F5033279C8187CBCBB29235D5F827</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>access_token</td> <td>string</td> <td>第三方登錄token</td> <td>89DC9691E274D6B596FFCB8D43368234</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>faceimg</td> <td>string</td> <td>用戶頭像</td> <td><a href="https://thirdqq.qlogo.cn/g?">https://thirdqq.qlogo.cn/g?</a>……</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>nickname</td> <td>string</td> <td>用戶昵稱</td> <td>消失的彩虹海</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>gender</td> <td>string</td> <td>用戶性別</td> <td>男</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>location</td> <td>string</td> <td>用戶所在地</td> <td>XXXXX市(僅限支付寶/微信返回)</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>ip</td> <td>string</td> <td>用戶登錄IP</td> <td>1.12.3.40</td> </tr> </tbody> </table></div> </div></div> </div></div> <h2 style="text-align: center;">獲取用戶信息</h2> <div data-v-380220c1="" id="doc-body"><div data-v-380220c1="" id="page_md_content" class="page_content_main" style="width: 95%;"><div data-v-380220c1="" id="editor-md" class="main-editor markdown-body editormd-html-preview"><p>在用戶登錄后的任意時間，可以請求以下接口再次查詢用戶的詳細信息。 </p> <p>請求URL： <code>https://www.ss349.cn/connect.php?act=query&appid={appid}&appkey={appkey}&type={登錄方式}&social_uid={social_uid}</code><br>social_uid就是用戶的第三方登錄UID，用于識別用戶的唯一字段。 </p> <p>返回格式：</p> <p>{<br> “code”: 0,<br> “msg”: “succ”,<br> “type”: “qq”,<br> “social_uid”: “AD3F5033279C8187CBCBB29235D5F827”,<br> “access_token”: “89DC9691E274D6B596FFCB8D43368234”,<br> “nickname”: “大白”,<br> “faceimg”: “<a href="https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185">https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185</a>“,<br> “location”: “XXXXX市”,<br> “gender”: “男”,<br> “ip”: “1.12.3.40”<br>}</p> <p>返回參數說明：</p> <div style="width: 100%;overflow-x: auto;"><table> <thead> <tr> <th style="width: 186px;">參數名</th> <th style="width: 186px;">參數類型</th> <th style="width: 186px;">參數說明</th> <th style="width: 186px;">參數示例</th> </tr> </thead> <tbody> <tr style="background-color: rgb(255, 255, 255);"> <td>code</td> <td>int</td> <td>返回狀態碼</td> <td>0為成功，其它值為失敗</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>msg</td> <td>string</td> <td>返回信息</td> <td>返回錯誤時的說明</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>type</td> <td>string</td> <td>登錄方式</td> <td>qq</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>social_uid</td> <td>string</td> <td>第三方登錄UID</td> <td>AD3F5033279C8187CBCBB29235D5F827</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>access_token</td> <td>string</td> <td>第三方登錄token</td> <td>89DC9691E274D6B596FFCB8D43368234</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>faceimg</td> <td>string</td> <td>用戶頭像</td> <td><a href="https://thirdqq.qlogo.cn/g?">https://thirdqq.qlogo.cn/g?</a>……</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>nickname</td> <td>string</td> <td>用戶昵稱</td> <td>消失的彩虹海</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>gender</td> <td>string</td> <td>用戶性別</td> <td>男</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>location</td> <td>string</td> <td>用戶所在地</td> <td>XXXXX市(僅限支付寶/微信返回)</td> </tr> <tr style="background-color: rgb(255, 255, 255);"> <td>ip</td> <td>string</td> <td>用戶登錄IP</td> <td>1.12.3.40</td> </tr> </tbody> </table></div> </div></div> </div> <h2 style="text-align: center;">SDK下載</h2> <div data-v-380220c1="" id="editor-md" class="main-editor markdown-body editormd-html-preview"><div class="card-body"><br><p>SDK版本：1.0</p><br><p><a href="https://www.ss349.cn/assets/files/SDK.zip">點擊下載</a></p><br></div> </div>