API 版本 1.1
本文档介绍了如何注册、配置和开发应用程序,以便成功使用我们的应用程序接口
创建应用程序
为了让您的应用程序访问我们的应用程序接口,您必须使用 应用程序仪表板. 注册会创建一个应用程序 ID,让我们知道您是谁,帮助我们将您的应用程序与其他应用程序区分开来.
- 您需要创建一个新的应用程序 创建新应用
- 创建应用程序后,您将获得 app_id 和 app_secret
Đăng nhập bằng
使用登录系统是人们创建账户和登录您的应用程序的一种快速便捷的方式。我们的 “Login With ”系统支持两种应用场景,即身份验证和请求访问用户数据的权限。您可以仅使用 “ ”登录系统进行身份验证,也可以同时使用该系统进行身份验证和数据访问.
-
开始 OAuth 登录过程时,您需要为应用程序使用一个链接,如下所示:
<a href="https://netquick.site/api/oauth?app_id=YOUR_APP_ID">Log in With 速友</a>
用户将被重定向到 “使用登录 ”页面,如下所示
-
一旦用户接受了您的应用程序,用户将被重定向到您的应用程序重定向 URL,其中包含 auth_key 这样:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
这 auth_key 仅一次性使用有效,因此一旦使用,将无法再获得和生成新代码,您需要再次将用户重定向至登录链接.
访问令牌
获得用户对应用程序的认可后 登录 “与 ”窗口,并返回 “与” auth_key 这意味着您现在可以从我们的应用程序接口获取数据了 access_token 您可以按照我们的步骤学习如何获得它.
-
要获取访问令牌,请像这样向以下端点发出 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://netquick.site/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 请求从系统中获取信息
端点 | 简介 |
---|---|
api/get_user_info | 获取用户信息 |
你可以这样获取用户信息
if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token $get = file_get_contents("https://netquick.site/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": "" } }