介面版本 1.1

本文檔介紹如何註冊、配置和開發應用，以便成功使用我們的 API

創建應用

為了使您的應用能夠訪問我們的 API，您必須使用 應用儀錶板. 註冊會創建一個應用 ID，讓我們知道你是誰，幫助我們區分你的應用與其他應用.

1. 您將需要創建一個新應用程式 創建新應用
2. 創建應用程式後，您將獲得您的 app_id 和 app_secret

登錄方式

使用系統登錄是人們創建帳戶和登錄應用程式的一種快速便捷的方式。 我們的“登錄方式”系統支援兩種方案，即身份認證和請求訪問人員資料的許可權。您可以使用“登錄方式”系統僅進行身份認證或同時進行身份認證和資料訪問.

1. 啟動 OAuth 登錄過程，您需要像這樣為您的應用程式使用連結:

   <a href="https://community.hot166.com/api/oauth?app_id=YOUR_APP_ID">Log in With Hot166</a>

   用戶將被重定向到如下所示的登錄方式頁面

   
2. 用戶獲得應用後，用戶將被重定向到你的應用重定向 URL，內容如下： auth_key 喜歡這個:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   這 auth_key 僅對一次性使用有效，因此一旦使用，您將無法再次使用它並生成新代碼，您需要再次將使用者重定向到使用連結登錄.

訪問權杖

獲得應用的使用者批准後，“登錄方式”視窗並返回 auth_key 這意味著現在您已準備好從我們的 API 檢索資料並開始此過程，您需要授權您的應用程式並獲得 access_token 您可以按照我們的步驟瞭解如何獲取它.

1. 若要獲取訪問權杖，請向以下終結點發出 HTTP GET 請求，如下所示:

               <?php
               $app_id = "YOUR_APP_ID"; // your app id
               $app_secret = "YOUR_APP_SECRET"; // your app secret
               $auth_key = $_GET['auth_key']; // the returned auth key from previous step
   
               $get = file_get_contents("https://community.hot166.com/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
   
               $json = json_decode($get, true);
               if(!empty($json['access_token'])) {
                   $access_token = $json['access_token']; // your access token
               }
               ?>                                                                                                
                               

   這 access_token 僅有效 1 小時，因此一旦無效，您將需要通過將使用者重定向到使用連結登錄來生成新的.

蜜蜂屬

一旦你得到你的 access_token 現在，您可以通過HTTP GET請求從我們的系統中檢索資訊，該請求支援以下參數：

您可以像這樣檢索使用者資訊

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://community.hot166.com/api/get_user_info?access_token=$access_token");
            }
                        

結果將是:

            {
              "user_info": {
              "user_id": "",
              "user_name": "",
              "user_email": "",
              "user_firstname": "",
              "user_lastname": "",
              "user_gender": "",
              "user_birthdate": "",
              "user_picture": "",
              "user_cover": "",
              "user_registered": "",
              "user_verified": "",
              "user_relationship": "",
              "user_biography": "",
              "user_website": ""
              }
            }