Nhà Phát Triển

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 của mình bằng cách sử dụng Trang Tổng Quan Ứng Dụng. Việc đăng ký sẽ tạo ID ứng dụng cho phép 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..

Bạn sẽ cần tạo một Ứng dụng mới Tạo Ứng Dụng Mới
Sau khi tạo Ứng dụng của mình, bạn sẽ nhận được app_id và app_secret

Đăng nhập với

Đăng nhập bằng hệ thống là cách nhanh chóng và thuận tiện để mọi người tạo ratà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 các kịch bản, xác thực và yêu cầu quyền truy cập vào thông tin của mọi người data. Bạn có thể sử dụng Đăng nhập bằng hệ thống chỉ để xác thực hoặc cho cả hai xác thực và truy cập dữ liệu.

Bắt đầu quá trình đăng nhập OAuth, Bạn cần sử dụng liên kết cho ứng dụng của mình như cái này:
```
<a href="https://me.vua.me/api/oauth?app_id=YOUR_APP_ID">Log in With MVM</a>
```
Người dùng sẽ được chuyển hướng đến trang Đăng nhập bằng như thế này
Sau khi người dùng tích lũy ứng dụng của bạn, người dùng sẽ được chuyển hướng đến Ứng dụng của bạn Chuyển hướng URL 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ị 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 lại bằng liên kết.

Chấp Nhận Mã Thông Báo Token

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, cửa sổ Đăng nhập bằng 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 cấp quyền cho ứng dụng của mình và nhậ 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 lấy nó.

Để nhận mã thông báo truy cập, hãy tạo 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://me.vua.me/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ó hiệu lực trong 1 giờ, vì vậy khi nó hết hiệu lực bạn sẽ cần phải tạo cái mới bằng cách chuyển hướng người dùng đến trang đăng nhập bằng liên kết lần nữa.

APIs

Một khi bạn nhận được của bạn 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 yêu cầu HTTP GET hỗ trợ các tham số sau

Điểm cuối	Miêu Tả Cần Thiết
api/get_user_info	lấy thông tin người dùng

Bạn có thể lấy lại 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://me.vua.me/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": ""
              }
            }