API版本 1.1

此文档介绍如何注册、配置和开发您的应用，以便成功使用我们的API

创建应用

为了让您的应用访问我们的API，您必须使用以下方法注册您的应用 应用仪表盘. 注册会生成一个应用ID，帮助我们识别您的身份，并区分您的应用和其他应用.

1. 您需要创建一个新应用 创建新应用
2. 一旦您创建了应用，您将获得 app_id 和 app_secret

使用以下方式登录

使用登录系统是一种快速方便的方式，用户可以通过它创建账户并登录您的应用。我们的登录系统支持两种场景：身份验证和请求访问用户数据的权限。您可以仅用于身份验证或同时用于身份验证和数据访问.

1. 启动OAuth登录流程时，您需要为应用使用这样的链接:

   <a href="https://www.loudook.com/api/oauth?app_id=YOUR_APP_ID">Log in With LouDooK</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://www.loudook.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小时，因此一旦失效，您需要将用户重定向到登录链接以生成新的令牌.

API接口

一旦您获得了 access_token 现在，您可以通过支持以下参数的HTTP GET请求从我们的系统检索信息

您可以像这样获取用户信息

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://www.loudook.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": ""
              }
            }