API dành cho Nhà phát triển

Bắt đầu

Một khóa API là cần thiết để các yêu cầu được hệ thống xử lý. Sau khi đăng ký, một khóa API sẽ được tự động tạo cho người dùng. Khóa API phải được gửi kèm mỗi yêu cầu (xem ví dụ đầy đủ bên dưới). Nếu không gửi khóa API hoặc khóa API đã hết hạn, sẽ xảy ra lỗi. Vui lòng giữ bí mật khóa API của bạn để tránh lạm dụng.

Xác thực

Để xác thực với hệ thống API, bạn cần gửi khóa API của mình dưới dạng token xác thực với mỗi yêu cầu. Xem ví dụ mã bên dưới.

curl --location --request POST 'https://linkrutgon.vn/api/account' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \ 
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => "https://linkrutgon.vn/api/account",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ],
));

$response = curl_exec($curl);
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/account',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: ''
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Giới hạn Tần suất

API của chúng tôi có giới hạn tần suất để bảo vệ khỏi các đợt tăng đột biến yêu cầu, nhằm tối đa hóa sự ổn định. Hiện tại, giới hạn này được đặt ở mức 30 yêu cầu mỗi 1 phút.

Một số header sẽ được gửi kèm theo phản hồi, bạn có thể kiểm tra chúng để xác định các thông tin liên quan đến yêu cầu.

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: TIMESTAMP
Xử lý Phản hồi

Tất cả phản hồi API mặc định được trả về ở định dạng JSON. Để chuyển đổi dữ liệu này thành dữ liệu có thể sử dụng được, cần sử dụng hàm phù hợp theo ngôn ngữ lập trình. Trong PHP, hàm json_decode() có thể được sử dụng để chuyển đổi dữ liệu thành đối tượng (mặc định) hoặc mảng (thiết lập tham số thứ hai là true). Điều rất quan trọng là kiểm tra khóa error để biết thông tin có xảy ra lỗi hay không. Bạn cũng có thể kiểm tra mã header.

{
  "error": 1,
  "message": "Đã xảy ra lỗi"
                }

Chiến dịch

Danh sách Chiến dịch
GET https://linkrutgon.vn/api/campaigns?limit=2&page=1

Để lấy danh sách chiến dịch của bạn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/campaigns?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/campaigns?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/campaigns?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "campaigns": [
            {
                "id": 1,
                "name": "Chi\u1ebfn d\u1ecbch M\u1eabu",
                "public": false,
                "rotator": false,
                "list": "https:\/\/domain.com\/u\/admin\/list-1"
            },
            {
                "id": 2,
                "domain": "Chi\u1ebfn d\u1ecbch Facebook",
                "public": true,
                "rotator": "https:\/\/domain.com\/r\/test",
                "list": "https:\/\/domain.com\/u\/admin\/test-2"
            }
        ]
    }
}
Tạo Chiến dịch
POST https://linkrutgon.vn/api/campaign/add

Bạn có thể thêm một chiến dịch bằng cách sử dụng endpoint này.

Tham sốMô tả
name (tùy chọn) Tên chiến dịch
slug (tùy chọn) Định danh Rotator
public (tùy chọn) Quyền truy cập
curl --location --request POST 'https://linkrutgon.vn/api/campaign/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Chi\u1ebfn d\u1ecbch M\u1edbi",
    "slug": "chien-dich-moi",
    "public": true
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/campaign/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "name": "Chi\u1ebfn d\u1ecbch M\u1edbi",
	    "slug": "chien-dich-moi",
	    "public": true
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/campaign/add',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "name": "Chi\u1ebfn d\u1ecbch M\u1edbi",
    "slug": "chien-dich-moi",
    "public": true
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 3,
    "domain": "Chi\u1ebfn d\u1ecbch M\u1edbi",
    "public": true,
    "rotator": "https:\/\/domain.com\/r\/chien-dich-moi",
    "list": "https:\/\/domain.com\/u\/admin\/chien-dich-moi-3"
}
Gán một Liên kết vào Chiến dịch
POST https://linkrutgon.vn/api/campaign/:campaignid/assign/:linkid

Một liên kết rút gọn có thể được gán vào một chiến dịch bằng cách sử dụng endpoint này. Endpoint yêu cầu ID của chiến dịch và ID của liên kết rút gọn.

curl --location --request POST 'https://linkrutgon.vn/api/campaign/:campaignid/assign/:linkid' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/campaign/:campaignid/assign/:linkid",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/campaign/:campaignid/assign/:linkid',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "Li\u00ean k\u1ebft \u0111\u00e3 \u0111\u01b0\u1ee3c th\u00eam v\u00e0o chi\u1ebfn d\u1ecbch th\u00e0nh c\u00f4ng."
}
Cập nhật Chiến dịch
PUT https://linkrutgon.vn/api/campaign/:id/update

Để cập nhật một chiến dịch, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu PUT. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
name (bắt buộc) Tên chiến dịch
slug (tùy chọn) Định danh Rotator
public (tùy chọn) Quyền truy cập
curl --location --request PUT 'https://linkrutgon.vn/api/campaign/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Chi\u1ebfn d\u1ecbch Twitter",
    "slug": "chien-dich-twitter",
    "public": true
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/campaign/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "name": "Chi\u1ebfn d\u1ecbch Twitter",
	    "slug": "chien-dich-twitter",
	    "public": true
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/campaign/:id/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "name": "Chi\u1ebfn d\u1ecbch Twitter",
    "slug": "chien-dich-twitter",
    "public": true
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 3,
    "domain": "Chi\u1ebfn d\u1ecbch Twitter",
    "public": true,
    "rotator": "https:\/\/domain.com\/r\/chien-dich-twitter",
    "list": "https:\/\/domain.com\/u\/admin\/chien-dich-twitter-3"
}
Xóa Chiến dịch
DELETE https://linkrutgon.vn/api/campaign/:id/delete

Để xóa một chiến dịch, bạn cần gửi một yêu cầu DELETE.

curl --location --request DELETE 'https://linkrutgon.vn/api/campaign/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/campaign/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'DELETE',
    'url': 'https://linkrutgon.vn/api/campaign/:id/delete',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "Chi\u1ebfn d\u1ecbch \u0111\u00e3 \u0111\u01b0\u1ee3c x\u00f3a th\u00e0nh c\u00f4ng."
}

Kênh

Danh sách Kênh
GET https://linkrutgon.vn/api/channels?limit=2&page=1

Để lấy danh sách kênh của bạn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/channels?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/channels?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "channels": [
            {
                "id": 1,
                "name": "K\u00eanh 1",
                "description": "M\u00f4 t\u1ea3 c\u1ee7a k\u00eanh 1",
                "color": "#000000",
                "starred": true
            },
            {
                "id": 2,
                "name": "K\u00eanh 2",
                "description": "M\u00f4 t\u1ea3 c\u1ee7a k\u00eanh 2",
                "color": "#FF0000",
                "starred": false
            }
        ]
    }
}
Lấy Dữ liệu Kênh Đã chọn
GET https://linkrutgon.vn/api/channel/:id?limit=1&page=1

Để lấy dữ liệu từ một kênh đã chọn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/channel/:id?limit=1&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channel/:id?limit=1&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/channel/:id?limit=1&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "items": [
            {
                "type": "li\u00ean k\u1ebft",
                "id": 1,
                "title": "Li\u00ean k\u1ebft M\u1eabu c\u1ee7a T\u00f4i",
                "preview": "https:\/\/google.com",
                "link": "https:\/\/linkrutgon.vn\/google",
                "date": "2022-05-12"
            },
            {
                "type": "ti\u1ec3u s\u1eed",
                "id": 1,
                "title": "Ti\u1ec3u s\u1eed M\u1eabu c\u1ee7a T\u00f4i",
                "preview": "https:\/\/linkrutgon.vn\/mybio",
                "link": "https:\/\/linkrutgon.vn\/mybio",
                "date": "2022-06-01"
            }
        ]
    }
}
Tạo Kênh
POST https://linkrutgon.vn/api/channel/add

Bạn có thể thêm một kênh bằng cách sử dụng endpoint này.

Tham sốMô tả
name (bắt buộc) Tên kênh
description (tùy chọn) Mô tả kênh
color (tùy chọn) Màu biểu tượng kênh (HEX)
starred (tùy chọn) Gắn dấu sao cho kênh hay không (true hoặc false)
curl --location --request POST 'https://linkrutgon.vn/api/channel/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "K\u00eanh M\u1edbi",
    "description": "m\u00f4 t\u1ea3 k\u00eanh m\u1edbi",
    "color": "#000000",
    "starred": true
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channel/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "name": "K\u00eanh M\u1edbi",
	    "description": "m\u00f4 t\u1ea3 k\u00eanh m\u1edbi",
	    "color": "#000000",
	    "starred": true
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/channel/add',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "name": "K\u00eanh M\u1edbi",
    "description": "m\u00f4 t\u1ea3 k\u00eanh m\u1edbi",
    "color": "#000000",
    "starred": true
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 3,
    "name": "K\u00eanh M\u1edbi",
    "description": "m\u00f4 t\u1ea3 k\u00eanh m\u1edbi",
    "color": "#000000",
    "starred": true
}
Gán một Mục vào Kênh
POST https://linkrutgon.vn/api/channel/:channelid/assign/:type/:itemid

Một mục có thể được gán vào bất kỳ kênh nào bằng cách gửi yêu cầu kèm theo ID kênh, loại mục (liên kết, tiểu sử hoặc QR) và ID mục.

Tham sốMô tả
:channelid (bắt buộc) ID của kênh
:type (bắt buộc) liên kết hoặc tiểu sử hoặc QR
:itemid (bắt buộc) ID của mục
curl --location --request POST 'https://linkrutgon.vn/api/channel/:channelid/assign/:type/:itemid' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channel/:channelid/assign/:type/:itemid",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/channel/:channelid/assign/:type/:itemid',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "M\u1ee5c \u0111\u00e3 \u0111\u01b0\u1ee3c th\u00eam v\u00e0o k\u00eanh th\u00e0nh c\u00f4ng."
}
Cập nhật Kênh
PUT https://linkrutgon.vn/api/channel/:id/update

Để cập nhật một kênh, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu PUT. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
name (tùy chọn) Tên kênh
description (tùy chọn) Mô tả kênh
color (tùy chọn) Màu biểu tượng kênh (HEX)
starred (tùy chọn) Gắn dấu sao cho kênh hay không (true hoặc false)
curl --location --request PUT 'https://linkrutgon.vn/api/channel/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Acme Corp",
    "description": "k\u00eanh d\u00e0nh cho c\u00e1c m\u1ee5c c\u1ee7a Acme Corp",
    "color": "#FFFFFF",
    "starred": false
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channel/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "name": "Acme Corp",
	    "description": "k\u00eanh d\u00e0nh cho c\u00e1c m\u1ee5c c\u1ee7a Acme Corp",
	    "color": "#FFFFFF",
	    "starred": false
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/channel/:id/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "name": "Acme Corp",
    "description": "k\u00eanh d\u00e0nh cho c\u00e1c m\u1ee5c c\u1ee7a Acme Corp",
    "color": "#FFFFFF",
    "starred": false
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "K\u00eanh \u0111\u00e3 \u0111\u01b0\u1ee3c c\u1eadp nh\u1eadt th\u00e0nh c\u00f4ng."
}
Xóa Kênh
DELETE https://linkrutgon.vn/api/channel/:id/delete

Để xóa một kênh, bạn cần gửi một yêu cầu DELETE. Tất cả các mục cũng sẽ được gỡ khỏi kênh.

curl --location --request DELETE 'https://linkrutgon.vn/api/channel/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/channel/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'DELETE',
    'url': 'https://linkrutgon.vn/api/channel/:id/delete',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "K\u00eanh \u0111\u00e3 \u0111\u01b0\u1ee3c x\u00f3a th\u00e0nh c\u00f4ng."
}

Liên kết


Lớp phủ CTA (Kêu gọi hành động)

Danh sách Lớp phủ CTA
GET https://linkrutgon.vn/api/overlay?limit=2&page=1

Để lấy danh sách lớp phủ CTA qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/overlay?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/overlay?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/overlay?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "cta": [
            {
                "id": 1,
                "type": "tin nh\u1eafn",
                "name": "Khuy\u1ebfn m\u00e3i S\u1ea3n ph\u1ea9m 1",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "type": "li\u00ean h\u1ec7",
                "name": "Trang Li\u00ean h\u1ec7",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}

Màn hình Tùy chỉnh

Danh sách Màn hình Tùy chỉnh
GET https://linkrutgon.vn/api/splash?limit=2&page=1

Để lấy danh sách các trang màn hình tùy chỉnh qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết)

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/splash?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/splash?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/splash?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "splash": [
            {
                "id": 1,
                "name": "Khuy\u1ebfn m\u00e3i S\u1ea3n ph\u1ea9m 1",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "name": "Khuy\u1ebfn m\u00e3i S\u1ea3n ph\u1ea9m 2",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}

Mã QR

Danh sách Mã QR
GET https://linkrutgon.vn/api/qr?limit=2&page=1

Để lấy danh sách mã QR của bạn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/qr?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/qr?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/qr?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "qrs": [
            {
                "id": 2,
                "link": "https:\/\/linkrutgon.vn\/qr\/a2d5e",
                "scans": 0,
                "name": "Google",
                "date": "2020-11-10 18:01:43"
            },
            {
                "id": 1,
                "link": "https:\/\/linkrutgon.vn\/qr\/b9edfe",
                "scans": 5,
                "name": "Google Canada",
                "date": "2020-11-10 18:00:25"
            }
        ]
    }
}
Lấy một Mã QR
GET https://linkrutgon.vn/api/qr/:id

Để lấy chi tiết của một mã QR qua API, bạn có thể sử dụng endpoint này.

curl --location --request GET 'https://linkrutgon.vn/api/qr/:id' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/qr/:id",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/qr/:id',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "details": {
        "id": 1,
        "link": "https:\/\/linkrutgon.vn\/qr\/b9edfe",
        "scans": 5,
        "name": "Google Canada",
        "date": "2020-11-10 18:00:25"
    },
    "data": {
        "clicks": 1,
        "uniqueClicks": 1,
        "topCountries": {
            "Kh\u00f4ng x\u00e1c \u0111\u1ecbnh": "1"
        },
        "topReferrers": {
            "Tr\u1ef1c ti\u1ebfp, email v\u00e0 c\u00e1c ngu\u1ed3n kh\u00e1c": "1"
        },
        "topBrowsers": {
            "Chrome": "1"
        },
        "topOs": {
            "Windows 10": "1"
        },
        "socialCount": {
            "facebook": 0,
            "twitter": 0,
            "instagram": 0
        }
    }
}
Tạo Mã QR
POST https://linkrutgon.vn/api/qr/add

Để tạo một mã QR, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu POST. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
type (bắt buộc) text | vcard | link | email | phone | sms | wifi
data (bắt buộc) Dữ liệu sẽ được nhúng vào mã QR. Dữ liệu có thể là chuỗi hoặc mảng tùy thuộc vào loại
background (tùy chọn) Màu nền RGB, ví dụ rgb(255,255,255)
foreground (tùy chọn) Màu chữ RGB, ví dụ rgb(0,0,0)
logo (tùy chọn) Đường dẫn tới logo dưới định dạng png hoặc jpg
curl --location --request POST 'https://linkrutgon.vn/api/qr/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/qr/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "type": "link",
	    "data": "https:\/\/google.com",
	    "background": "rgb(255,255,255)",
	    "foreground": "rgb(0,0,0)",
	    "logo": "https:\/\/site.com\/logo.png"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/qr/add',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 3,
    "link": "https:\/\/linkrutgon.vn\/qr\/a58f79"
}
Cập nhật Mã QR
PUT https://linkrutgon.vn/api/qr/:id/update

Để cập nhật một mã QR, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu PUT. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
data (bắt buộc) Dữ liệu sẽ được nhúng vào mã QR. Dữ liệu có thể là chuỗi hoặc mảng tùy thuộc vào loại
background (tùy chọn) Màu nền RGB, ví dụ rgb(255,255,255)
foreground (tùy chọn) Màu chữ RGB, ví dụ rgb(0,0,0)
logo (tùy chọn) Đường dẫn tới logo dưới định dạng png hoặc jpg
curl --location --request PUT 'https://linkrutgon.vn/api/qr/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/qr/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "type": "link",
	    "data": "https:\/\/google.com",
	    "background": "rgb(255,255,255)",
	    "foreground": "rgb(0,0,0)",
	    "logo": "https:\/\/site.com\/logo.png"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/qr/:id/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "M\u00e3 QR \u0111\u00e3 \u0111\u01b0\u1ee3c c\u1eadp nh\u1eadt th\u00e0nh c\u00f4ng."
}
Xóa Mã QR
DELETE https://linkrutgon.vn/api/qr/:id/delete

Để xóa một mã QR, bạn cần gửi một yêu cầu DELETE.

curl --location --request DELETE 'https://linkrutgon.vn/api/qr/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/qr/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'DELETE',
    'url': 'https://linkrutgon.vn/api/qr/:id/delete',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "M\u00e3 QR \u0111\u00e3 \u0111\u01b0\u1ee3c x\u00f3a th\u00e0nh c\u00f4ng."
}

Pixel

Danh sách Pixel
GET https://linkrutgon.vn/api/pixels?limit=2&page=1

Để lấy danh sách mã pixel của bạn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/pixels?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/pixels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/pixels?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "pixels": [
            {
                "id": 1,
                "type": "gtmpixel",
                "name": "GTM Pixel",
                "tag": "GA-123456789",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "type": "twitterpixel",
                "name": "Twitter Pixel",
                "tag": "1234567",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}
Tạo Pixel
POST https://linkrutgon.vn/api/pixel/add

Một pixel có thể được tạo bằng endpoint này. Bạn cần gửi loại pixel và mã tag.

Tham sốMô tả
type (bắt buộc) gtmpixel | gapixel | fbpixel | adwordspixel | linkedinpixel | twitterpixel | adrollpixel | quorapixel | pinterest | bing | snapchat | reddit | tiktok
name (bắt buộc) Tên tùy chỉnh cho pixel của bạn
tag (bắt buộc) Mã tag của pixel
curl --location --request POST 'https://linkrutgon.vn/api/pixel/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "gtmpixel",
    "name": "GTM c\u1ee7a t\u00f4i",
    "tag": "GTM-ABCDE"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/pixel/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "type": "gtmpixel",
	    "name": "GTM c\u1ee7a t\u00f4i",
	    "tag": "GTM-ABCDE"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/pixel/add',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "type": "gtmpixel",
    "name": "GTM c\u1ee7a t\u00f4i",
    "tag": "GTM-ABCDE"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 1
}
Cập nhật Pixel
PUT https://linkrutgon.vn/api/pixel/:id/update

Để cập nhật một pixel, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu PUT. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
name (tùy chọn) Tên tùy chỉnh cho pixel của bạn
tag (bắt buộc) Mã tag của pixel
curl --location --request PUT 'https://linkrutgon.vn/api/pixel/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "GTM c\u1ee7a t\u00f4i",
    "tag": "GTM-ABCDE"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/pixel/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "name": "GTM c\u1ee7a t\u00f4i",
	    "tag": "GTM-ABCDE"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/pixel/:id/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "name": "GTM c\u1ee7a t\u00f4i",
    "tag": "GTM-ABCDE"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "Pixel \u0111\u00e3 \u0111\u01b0\u1ee3c c\u1eadp nh\u1eadt th\u00e0nh c\u00f4ng."
}
Xóa Pixel
DELETE https://linkrutgon.vn/api/pixel/:id/delete

Để xóa một pixel, bạn cần gửi một yêu cầu DELETE.

curl --location --request DELETE 'https://linkrutgon.vn/api/pixel/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/pixel/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'DELETE',
    'url': 'https://linkrutgon.vn/api/pixel/:id/delete',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "Pixel \u0111\u00e3 \u0111\u01b0\u1ee3c x\u00f3a th\u00e0nh c\u00f4ng."
}

Tài khoản

Lấy thông tin Tài khoản
GET https://linkrutgon.vn/api/account

Để lấy thông tin tài khoản, bạn có thể gửi yêu cầu đến endpoint này và nó sẽ trả về dữ liệu liên quan đến tài khoản.

curl --location --request GET 'https://linkrutgon.vn/api/account' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/account',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "data": {
        "id": 1,
        "email": "[email protected]",
        "username": "sampleuser",
        "avatar": "https:\/\/domain.com\/content\/avatar.png",
        "status": "pro",
        "expires": "2022-11-15 15:00:00",
        "registered": "2020-11-10 18:01:43"
    }
}
Cập nhật Tài khoản
PUT https://linkrutgon.vn/api/account/update

Để cập nhật thông tin tài khoản, bạn có thể gửi yêu cầu đến endpoint này và nó sẽ cập nhật dữ liệu liên quan đến tài khoản.

curl --location --request PUT 'https://linkrutgon.vn/api/account/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "[email protected]",
    "password": "newpassword"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/account/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "email": "[email protected]",
	    "password": "newpassword"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/account/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "email": "[email protected]",
    "password": "newpassword"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "T\u00e0i kho\u1ea3n \u0111\u00e3 \u0111\u01b0\u1ee3c c\u1eadp nh\u1eadt th\u00e0nh c\u00f4ng."
}

Tên miền thương hiệu

Danh sách Tên miền Thương hiệu
GET https://linkrutgon.vn/api/domains?limit=2&page=1

Để lấy danh sách tên miền thương hiệu của bạn qua API, bạn có thể sử dụng endpoint này. Bạn cũng có thể lọc dữ liệu (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
limit (tùy chọn) Số lượng kết quả trên mỗi trang
page (tùy chọn) Yêu cầu trang hiện tại
curl --location --request GET 'https://linkrutgon.vn/api/domains?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/domains?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'GET',
    'url': 'https://linkrutgon.vn/api/domains?limit=2&page=1',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "domains": [
            {
                "id": 1,
                "domain": "https:\/\/domain1.com",
                "redirectroot": "https:\/\/rootdomain.com",
                "redirect404": "https:\/\/rootdomain.com\/404"
            },
            {
                "id": 2,
                "domain": "https:\/\/domain2.com",
                "redirectroot": "https:\/\/rootdomain2.com",
                "redirect404": "https:\/\/rootdomain2.com\/404"
            }
        ]
    }
}
Tạo Tên miền Thương hiệu
POST https://linkrutgon.vn/api/domain/add

Bạn có thể thêm một tên miền bằng cách sử dụng endpoint này. Vui lòng đảm bảo tên miền được trỏ đúng đến máy chủ của chúng tôi.

Tham sốMô tả
domain (bắt buộc) Tên miền thương hiệu bao gồm http hoặc https
redirectroot (tùy chọn) Chuyển hướng gốc khi ai đó truy cập tên miền của bạn
redirect404 (tùy chọn) Chuyển hướng lỗi 404 tùy chỉnh
curl --location --request POST 'https://linkrutgon.vn/api/domain/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domain": "https:\/\/domain1.com",
    "redirectroot": "https:\/\/rootdomain.com",
    "redirect404": "https:\/\/rootdomain.com\/404"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/domain/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "domain": "https:\/\/domain1.com",
	    "redirectroot": "https:\/\/rootdomain.com",
	    "redirect404": "https:\/\/rootdomain.com\/404"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'POST',
    'url': 'https://linkrutgon.vn/api/domain/add',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "domain": "https:\/\/domain1.com",
    "redirectroot": "https:\/\/rootdomain.com",
    "redirect404": "https:\/\/rootdomain.com\/404"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "id": 1
}
Cập nhật Tên miền
PUT https://linkrutgon.vn/api/domain/:id/update

Để cập nhật một tên miền thương hiệu, bạn cần gửi dữ liệu hợp lệ dưới dạng JSON thông qua yêu cầu PUT. Dữ liệu phải được gửi dưới dạng nội dung thô của yêu cầu như minh họa bên dưới. Ví dụ bên dưới hiển thị tất cả các tham số bạn có thể gửi, nhưng không bắt buộc phải gửi tất cả (Xem bảng để biết thêm chi tiết).

Tham sốMô tả
redirectroot (tùy chọn) Chuyển hướng gốc khi ai đó truy cập tên miền của bạn
redirect404 (tùy chọn) Chuyển hướng lỗi 404 tùy chỉnh
curl --location --request PUT 'https://linkrutgon.vn/api/domain/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "redirectroot": "https:\/\/rootdomain-new.com",
    "redirect404": "https:\/\/rootdomain-new.com\/404"
}'
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/domain/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],
CURLOPT_POSTFIELDS => 
    '{
	    "redirectroot": "https:\/\/rootdomain-new.com",
	    "redirect404": "https:\/\/rootdomain-new.com\/404"
	}',
                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'PUT',
    'url': 'https://linkrutgon.vn/api/domain/:id/update',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "redirectroot": "https:\/\/rootdomain-new.com",
    "redirect404": "https:\/\/rootdomain-new.com\/404"
}),
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "T\u00ean mi\u1ec1n \u0111\u00e3 \u0111\u01b0\u1ee3c c\u1eadp nh\u1eadt th\u00e0nh c\u00f4ng."
}
Xóa Tên miền
DELETE https://linkrutgon.vn/api/domain/:id/delete

Để xóa một tên miền, bạn cần gửi một yêu cầu DELETE.

curl --location --request DELETE 'https://linkrutgon.vn/api/domain/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();

                                        curl_setopt_array($curl, array(
CURLOPT_URL => "https://linkrutgon.vn/api/domain/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
],

                                        ));

                                        $response = curl_exec($curl);

                                        curl_close($curl);
                                        echo $response;
var request = require('request');
var options = {
    'method': 'DELETE',
    'url': 'https://linkrutgon.vn/api/domain/:id/delete',
    'headers': {
        'Authorization': 'Bearer YOURAPIKEY',
        'Content-Type': 'application/json'
    },
    
};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});
Phản hồi từ máy chủ
{
    "error": 0,
    "message": "T\u00ean mi\u1ec1n \u0111\u00e3 \u0111\u01b0\u1ee3c x\u00f3a th\u00e0nh c\u00f4ng."
}