API版本 1.1

本文檔說明如何註冊、配置和開發您的應用程序，以便您可以成功使用我們的 API

創建應用程式

為了讓您的應用程式存取我們的 API，您必須使用 應用程式儀表板. 註冊會建立一個應用程式 ID，讓我們知道您是誰，幫助我們將您的應用程式與其他應用程式區分開來.

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

登入方式

使用系統登入是人們建立帳戶和登入您的應用程式的快速便捷的方式。 我們的登入系統支援兩種場景：身份驗證和請求存取人員資料的權限。 您可以使用登入系統僅進行身份驗證或同時進行身份驗證和資料訪問.

1. 開始 OAuth 登入過程，您需要使用您的應用程式的鏈接，如下所示:

   <a href="https://digu.tw/api/oauth?app_id=YOUR_APP_ID">Log in With 嘀咕｜隨時嘀我一下</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://digu.tw/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://digu.tw/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": ""
              }
            }