Tài liệu

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 API của chúng tôi

Tạo ứng dụng

Để ứng dụng của bạn truy cập API của chúng tôi, bạn phải đăng ký ứng dụng bằng cách sử dụng Bảng điều khiển ứng dụng. Việc đăng ký sẽ 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 새 앱 만들기
  2. Khi bạn đã tạo Ứng dụng của mình, bạn sẽ nhận được app_idapp_secret
로 로그인

Đăng nhập bằng 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 nhập vào ứng dụng của bạn. Hệ thống Đăng nhập Với của chúng tôi cho phép hai kịch bản, xác thực 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 hệ thống Đăng nhập bằng giản chỉ để 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://netquick.site/api/oauth?app_id=YOUR_APP_ID">Log in With 넷퀵</a>

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

  2. Sau khi người dùng truy cập ứ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 bằng auth_key như thế này:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Đây auth_key Chỉ có giá trị sử dụng một lần, vì vậy một 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.
Token truy cập

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, hãy đăng nhập bằng cửa sổ và quay 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ừ API của chúng tôi và để bắt đầu quá trình này, bạn sẽ cần ủy quyền cho ứng dụng của mình và nhận access_token Và bạn có thể làm theo các bước của chúng tôi để tìm hiểu làm thế nào để có được nó.

  1. Để nhận access token, hãy tạo một HTTP GET request đến endpoint sau như sau:
                <?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
                }
                ?>                                                                                                
                                
    Đây access_token chỉ có hiệu lực trong 1 giờ, vì vậy khi nó không hợp lệ, bạn sẽ cần phải tạo lạ 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"

Một khi bạn nhận được access_token Bây giờ 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

Endpoint Mô tả
api/get_user_info

lấy thông tin người dùng

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://netquick.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": ""
              }
            }