API 版本 1.1

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

創建應用程式

為了讓您的應用程式訪問我們的 API，您必須使用註冊您的應用程式 應用程式面板. 註冊創建一個應用程式 ID，讓我們知道您是誰，幫助我們將您的應用程式與其他應用程序區分開來.

1. 您需要創建一個新的應用程式 創建新應用
2. 一旦您創建了您的應用程式，您就會得到您的 app_id 和 app_secret

使用合作商帳戶登入

使用系統登錄是人們創建帳戶並登入到您的應用程式的一種快速便捷的方式我們的登錄系統支持兩個場景，身份驗證和請求訪問人員數據的權限您可以使用 login with system 簡單地進行身份驗證，或者同時進行身份驗證和數據訪問.

1. 在開始 OAuth 登錄過程時，您需要使用應用程式的連結，如下所示:

   <a href="/api/oauth?app_id=YOUR_APP_ID">Log in With RubberX</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("/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("/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": ""
                                                  }
                                                }