🚀 Bắt đầu với VipLikeSub.net API v2

Chào mừng bạn đến với tài liệu API của VipLikeSub.net. Hướng dẫn này sẽ giúp bạn tích hợp và sử dụng các dịch vụ của chúng tôi một cách hiệu quả.

Base URL

Tất cả các yêu cầu API đều phải được gửi đến Base URL sau:

http://viplikesub.net/api/v2

Định dạng Phản hồi (Response)

Mọi phản hồi từ API đều tuân theo cấu trúc JSON chuẩn để đảm bảo tính nhất quán:

success (boolean): Trạng thái thành công của yêu cầu.
data (object | array): Dữ liệu trả về khi thành công.
items (array): Dữ liệu trả về cho các yêu cầu danh sách có phân trang.
errors (array): Danh sách các lỗi nếu yêu cầu thất bại.

🔐 Xác thực API

Hệ thống sử dụng phương thức xác thực bằng API Token. Bạn cần gửi token trong header của mỗi yêu cầu.

Header yêu cầu: X-API-Token: YOUR_API_TOKEN

Để lấy API Token, vui lòng thực hiện các bước sau:

Đăng nhập vào hệ thống VipLikeSub.net.
Điều hướng đến trang Profile → Dashboard.
Chọn tab "API Token".
Sao chép token hoặc tạo lại nếu cần. API Token là vĩnh viễn và không hết hạn.

📦 API Dịch vụ

Các endpoints để quản lý và truy vấn thông tin về danh mục và dịch vụ.

POSTLấy danh sách danh mục

Truy vấn danh sách các danh mục dịch vụ với tùy chọn tìm kiếm và phân trang.

Endpoint: /category-service

Request Body:

Trường	Kiểu	Mô tả
`pageIndex`	Integer	Chỉ số trang (mặc định: 1).
`pageSize`	Integer	Số mục trên mỗi trang (mặc định: 10).
`entity`	String	(Tùy chọn) Từ khóa tìm kiếm.

GETLấy chi tiết dịch vụ

Lấy thông tin chi tiết của một dịch vụ cụ thể dựa trên ID.

Endpoint: /service/{serviceId}

Path Parameters:

Trường	Kiểu	Mô tả
`serviceId`	GUID	ID của dịch vụ cần lấy thông tin.

🛒 API Đơn hàng

Các endpoints để tạo, kiểm tra và quản lý đơn hàng.

POSTTạo đơn hàng mới

Tạo một đơn hàng mới cho một dịch vụ cụ thể.

Endpoint: /create-order

Request Body:

Trường	Kiểu	Mô tả
`serverServiceId`	GUID	ID của máy chủ dịch vụ (server-service).
`quantity`	Integer	Số lượng.
`note`	String	(Tùy chọn) Ghi chú cho đơn hàng.

POSTKiểm tra trạng thái đơn hàng

Kiểm tra trạng thái của một hoặc nhiều đơn hàng bằng mã đơn hàng.

Endpoint: /check-order-status

Request Body (Form Data):

Trường	Kiểu	Mô tả
`orderCodes[]`	Array[String]	Mảng các mã đơn hàng cần kiểm tra.

💻 Ví dụ Code mẫu

Các đoạn code mẫu giúp bạn tích hợp nhanh chóng bằng nhiều ngôn ngữ phổ biến.

Đây là các ví dụ về cách tạo một API client đơn giản để tương tác với hệ thống.

📞 Hỗ trợ

Nếu bạn gặp bất kỳ vấn đề nào hoặc cần thêm API, đừng ngần ngại liên hệ với chúng tôi.

Email: [email protected]
Telegram: @VipLikeSub.net_support
Website: VipLikeSub.net


# Lấy danh sách danh mục
curl -X POST 'http://viplikesub.net/api/v2/category-service' \
  -H 'X-API-Token: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "pageIndex": 1,
    "pageSize": 5
  }'

# Tạo đơn hàng
curl -X POST 'http://viplikesub.net/api/v2/create-order' \
  -H 'X-API-Token: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "serverServiceId": "your-server-service-id",
    "quantity": 1000,
    "note": "API test order"
  }'


const API_BASE_URL = 'http://viplikesub.net/api/v2';
const API_TOKEN = 'YOUR_API_TOKEN';

async function apiRequest(endpoint, method = 'GET', body = null) {
  const headers = {
    'Content-Type': 'application/json',
    'X-API-Token': API_TOKEN
  };
  
  const config = {
    method,
    headers
  };
  
  if (body) {
    config.body = JSON.stringify(body);
  }
  
  const response = await fetch(`${API_BASE_URL}${endpoint}`, config);
  
  if (!response.ok) {
    throw new Error(`API request failed: ${response.statusText}`);
  }
  
  return response.json();
}

// Ví dụ: Lấy danh mục
apiRequest('/category-service', 'POST', { pageIndex: 1, pageSize: 5 })
  .then(data => console.log('Categories:', data))
  .catch(error => console.error(error));

// Ví dụ: Tạo đơn hàng
const orderData = {
  serverServiceId: 'your-server-service-id',
  quantity: 1,
  note: 'Test order from JS'
};
apiRequest('/create-order', 'POST', orderData)
  .then(data => console.log('Order created:', data))
  .catch(error => console.error(error));


import requests
import json

API_BASE_URL = 'http://viplikesub.net/api/v2'
API_TOKEN = 'YOUR_API_TOKEN'

def api_request(endpoint, method='GET', data=None):
    headers = {
        'Content-Type': 'application/json',
        'X-API-Token': API_TOKEN
    }
    
    url = f"{API_BASE_URL}{endpoint}"
    
    try:
        if method.upper() == 'POST':
            response = requests.post(url, headers=headers, json=data)
        else:
            response = requests.get(url, headers=headers)
        
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"API request error: {e}")
        return None

# Ví dụ: Lấy danh mục
categories = api_request('/category-service', 'POST', {'pageIndex': 1, 'pageSize': 5})
if categories:
    print("Categories:", json.dumps(categories, indent=2))

# Ví dụ: Tạo đơn hàng
order_data = {
    "serverServiceId": "your-server-service-id",
    "quantity": 1,
    "note": "Test order from Python"
}
new_order = api_request('/create-order', 'POST', order_data)
if new_order:
    print("Order Created:", json.dumps(new_order, indent=2))

<?php

const API_BASE_URL = 'http://viplikesub.net/api/v2';
const API_TOKEN = 'YOUR_API_TOKEN';

function apiRequest($endpoint, $method = 'GET', $data = null) {
    $url = API_BASE_URL . $endpoint;
    
    $headers = [
        'Content-Type: application/json',
        'X-API-Token: ' . API_TOKEN
    ];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);

    if ($data && in_array($method, ['POST', 'PUT'])) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    }

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode >= 400) {
        error_log("API Request Failed with status {$httpCode}: {$response}");
        return null;
    }

    return json_decode($response, true);
}

// Ví dụ: Lấy danh mục
$categories = apiRequest('/category-service', 'POST', [
    'pageIndex' => 1, 
    'pageSize' => 5
]);
print_r($categories);

// Ví dụ: Tạo đơn hàng
$orderData = [
    'serverServiceId' => 'your-server-service-id',
    'quantity' => 1,
    'note' => 'Test order from PHP'
];
$newOrder = apiRequest('/create-order', 'POST', $orderData);
print_r($newOrder);

?>