Phiên bản API 1.1

Tài liệu này giải thích cách đăng ký, định cấu hình và phát triển ứng dụng của bạn để bạn có thể sử dụng thành công các API của chúng tôi

Tạo ứng dụng

Để ứng dụng của bạn có thể truy cập các API của chúng tôi, bạn phải đăng ký ứng dụng của mình bằng Trang tổng quan ứng dụng. Đăng ký tạo ID ứng dụng cho chúng tôi biết bạn là ai, giúp chúng tôi phân biệt ứng dụng của bạn với các ứng dụng khác.

1. Bạn sẽ cần tạo một ứng dụng mới Tạo ứng dụng mới
2. Sau khi tạo ứng dụng, bạn sẽ nhận được app_id và app_secret

Đăng nhập với

Đăng nhập Với hệ thống là một cách nhanh chóng và thuận tiện để mọi người tạo tài khoản và đăng nhập vào ứng dụng của bạn. Hệ thống Đăng nhập bằng của chúng tôi cho phép hai tình huống, xác thực và yêu cầu quyền truy cập dữ liệu của mọi người. Bạn có thể sử dụng Đăng nhập với hệ thống đơn giản để xác thực hoặc cho cả xác thực và truy cập dữ liệu.

1. Bắt đầu quá trình đăng nhập OAuth, Bạn cần sử dụng một liên kết cho ứng dụng của mình như thế này:

   <a href="https://alexsiudeptry.site/api/oauth?app_id=YOUR_APP_ID">Log in With Peach</a>

   Người dùng sẽ được chuyển hướng đến trang đăng nhập bằng trang như thế này

   
2. Sau khi người dùng chấp nhận ứng dụng của bạn, người dùng sẽ được chuyển hướng đến URL chuyển hướng ứng dụng của bạn với auth_key như thế này:

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

   Điều này auth_key chỉ có giá trị cho việc sử dụng một lần, vì vậy khi bạn đã sử dụng nó, bạn sẽ không thể sử dụng lại và tạo mã mới, bạn sẽ cần chuyển hướng người dùng đến đăng nhập bằng liên kết một lần nữa.

Access Token

Sau khi bạn nhận được sự chấp thuận của người dùng đối với ứng dụng của mình, Đăng nhập bằng cửa sổ và được trả lại với auth_key có nghĩa là bây giờ bạn đã sẵn sàng truy xuất dữ liệu từ các API của chúng tôi và để bắt đầu quá trình này, bạn sẽ cần cấp quyền cho ứng dụng của mình và tải xuống access_token và bạn có thể làm theo các bước của chúng tôi để tìm hiểu cách tải xuống.

1. Để nhận mã access token, hãy thực hiện yêu cầu HTTP GET tới điểm cuối sau như thế này:

   <?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://alexsiudeptry.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
   }
   ?>

   Điều này access_token chỉ có giá trị trong 1 giờ, vì vậy khi nó không hợp lệ, bạn sẽ cần tạo một cái mới bằng cách chuyển hướng người dùng đến đăng nhập bằng liên kết một lần nữa.

API

Khi bạn nhận được access_token Giờ đây, bạn có thể truy xuất thông tin từ hệ thống của chúng tôi thông qua các yêu cầu HTTP GET hỗ trợ các tham số sau

Bạn có thể lấy thông tin người dùng như thế này

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

Kết quả sẽ là:

{
    "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": ""
    }
}