Đăng nhập
Cloud VPS Proxy Tên miền Tạo website Cronjob
Cloud VPS Proxy Tên miền Tạo website Cronjob
Trang chủ
Dịch vụ
Nạp tiền
Lịch sử
Tài khoản

Tài liệu API Tên Miền (Domain API)

Hệ thống API Tên miền cung cấp giải pháp tự động hóa toàn diện cho các nhà phát triển và đại lý (Reseller): Tra cứu khả dụng, kiểm tra WHOIS, đăng ký tên miền tức thì từ số dư tài khoản, quản lý danh sách và cập nhật Nameservers linh hoạt.

Base URL: https://lpkvps.cfd Định dạng: JSON (UTF-8) Xác thực: Authorization: Bearer Chuẩn tài liệu: DichVuDark.vip v2 (Mục 5)

5.1. Cơ Chế Xác Thực Domain API

Bạn chưa đăng nhập
Đăng nhập để xem Token API cá nhân và số dư ví. Dùng placeholder YOUR_API_TOKEN khi thử nghiệm.
Đăng nhập ngay

1. Header Chuẩn: Authorization Bearer

Truyền qua HTTP Request Header chuẩn:

Authorization: Bearer YOUR_API_TOKEN

2. Tham số Query URL hoặc Body

Thêm trực tiếp vào query string hoặc form data:

GET /api/domain/list?token=YOUR_API_TOKEN
Quy định & Điều kiện tiên quyết:
  • Số dư tài khoản: Khi gọi API đăng ký tên miền, hệ thống sẽ kiểm tra và trừ tiền trực tiếp trên số dư ví của tài khoản tương ứng với bảng giá niêm yết.
  • Hồ sơ chủ thể (Registrant Profile): Trước khi mua tên miền, tài khoản cần cập nhật đầy đủ thông tin chủ thể tại Hồ sơ cá nhân (Họ tên, Email, Số điện thoại, Địa chỉ, Tỉnh/Thành phố, Mã bưu chính).
  • Nameservers mặc định: Nếu bạn không truyền cặp Nameservers riêng, hệ thống tự động gán cặp Cloudflare Nameserver mặc định (duke.ns.cloudflare.com, uma.ns.cloudflare.com).
Menu Domain: Xác thực GET Kiểm tra tên miền GET Bảng giá TLDs POST Mua tên miền GET Danh sách tên miền POST Đổi Nameservers GET Chi tiết & DNS Code Mẫu SDK
GET

5.2. Kiểm Tra Tên Miền & Tra Cứu Giá

/api/domain/check (Alias: /api/domain/search)

Kiểm tra tên miền có thể đăng ký được hay không, giá mua năm đầu và giá gia hạn. Endpoint này là Public API (công khai), người dùng hoặc đối tác có thể gọi tra cứu tình trạng và giá mà không bắt buộc phải đăng nhập hay truyền token.

Endpoint URL
GET https://lpkvps.cfd/api/domain/check?domain={domain} Public API
Tham số Request
Tham sốKiểuBắt buộcMô tả
domainstringBắt buộcTên miền cần kiểm tra (ví dụ: domaincuaban.com)
Ví dụ cURL
curl -X GET "https://lpkvps.cfd/api/domain/check?domain=domaincuaban.com"
Response Mẫu (Tên miền còn trống / Khả dụng)
{
  "status": "success",
  "domain": "domaincuaban.com",
  "tld": "com",
  "available": true,
  "price": 356000,
  "renew_price": 399000,
  "is_premium": false,
  "currency": "VND",
  "message": "Tên miền còn trống"
}
Response Mẫu (Tên miền đã được đăng ký)
{
  "status": "success",
  "domain": "google.com",
  "tld": "com",
  "available": false,
  "price": 0,
  "renew_price": 0,
  "is_premium": false,
  "currency": "VND",
  "message": "Tên miền đã được đăng ký"
}
GET

5.3. Bảng Giá Toàn Bộ TLDs

/api/domain/pricing

Lấy toàn bộ danh sách đuôi tên miền (TLD), giá đăng ký, giá gia hạn hàng năm đang mở bán trên hệ thống. Hỗ trợ cả 2 định dạng: data (Object tra cứu nhanh theo key đuôi) và list (Mảng để hiển thị danh sách/dropdown).

Endpoint URL
GET https://lpkvps.cfd/api/domain/pricing Public API
Ví dụ cURL
curl -X GET "https://lpkvps.cfd/api/domain/pricing"
Response Mẫu (200 OK)
{
  "status": "success",
  "data": {
    "com": { "tld": "com", "register": 356000, "renew": 399000, "register_price": 356000, "renew_price": 399000 },
    "net": { "tld": "net", "register": 447000, "renew": 447000, "register_price": 447000, "renew_price": 447000 },
    "xyz": { "tld": "xyz", "register": 81000, "renew": 499000, "register_price": 81000, "renew_price": 499000 }
  },
  "list": [
    { "tld": "com", "register": 356000, "renew": 399000, "register_price": 356000, "renew_price": 399000 },
    { "tld": "net", "register": 447000, "renew": 447000, "register_price": 447000, "renew_price": 447000 },
    { "tld": "xyz", "register": 81000, "renew": 499000, "register_price": 81000, "renew_price": 499000 }
  ]
}
POST

5.4. Đặt Mua / Đăng Ký Tên Miền Tự Động

/api/domain/buy (Alias: /api/domain/order)

Thực hiện đăng ký tên miền ngay lập tức. Hệ thống sẽ tự động trừ số dư ví, gán thông tin chủ thể registrant và trỏ cặp Nameservers chỉ định.

Endpoint URL
POST https://lpkvps.cfd/api/domain/buy Content-Type: application/json
Request Parameters
Tham sốKiểuBắt buộcMặc địnhMô tả
domainstringBắt buộc-Tên miền muốn mua (ví dụ: mybrandshop.com)
periodintegerTuỳ chọn1Số năm đăng ký (1 - 10 năm)
nameserver_1stringBắt buộc-Nameserver cấp 1 (ví dụ: ns1.myhost.com)
nameserver_2stringBắt buộc-Nameserver cấp 2 (ví dụ: ns2.myhost.com)
privacy_protectionintegerTuỳ chọn1Bật ẩn thông tin WHOIS (1 = Bật, 0 = Tắt)
auto_renewintegerTuỳ chọn0Tự động gia hạn khi hết hạn (1 = Bật, 0 = Tắt)
tokenstringTuỳ chọn-API Token nếu không truyền qua Header
Ví dụ cURL
curl -X POST "https://lpkvps.cfd/api/domain/buy" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "domain": "mybrandshop.com", "period": 1, "nameserver_1": "ns1.myhost.com", "nameserver_2": "ns2.myhost.com", "privacy_protection": 1 }'
Response Mẫu Thành Công (200 OK)
{
  "status": "success",
  "msg": "Đã tạo đơn tên miền thành công",
  "message": "Đã tạo đơn tên miền thành công",
  "data": {
    "domain": "mybrandshop.com",
    "tld": "com",
    "period": 1,
    "price": 356000,
    "unit_price": 356000,
    "renew_price": 399000,
    "is_premium": false,
    "nameservers": [
      "ns1.myhost.com",
      "ns2.myhost.com"
    ],
    "status": "pending"
  }
}
GET

5.5. Danh Sách Tên Miền Đã Sở Hữu

/api/domain/list

Lấy danh sách toàn bộ các tên miền đang quản lý thuộc tài khoản của bạn, hỗ trợ phân trang và tìm kiếm theo từ khóa.

Endpoint URL
GET https://lpkvps.cfd/api/domain/list
Query Parameters
Tham sốKiểuBắt buộcMặc địnhMô tả
pageintegerTuỳ chọn1Số thứ tự trang hiện tại
limitintegerTuỳ chọn20Số bản ghi mỗi trang (tối đa 100)
searchstringTuỳ chọn-Tìm kiếm theo tên miền hoặc từ khóa
tokenstringTuỳ chọn-API Token nếu không truyền qua Header
Ví dụ cURL
curl -X GET "https://lpkvps.cfd/api/domain/list?page=1&limit=20" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"
Response Mẫu (200 OK)
{
  "status": "success",
  "data": {
    "list": [
      {
        "id": 105,
        "domain": "mybrandshop.com",
        "tld": "com",
        "period": 1,
        "status": "active",
        "nameserver_1": "ns1.myhost.com",
        "nameserver_2": "ns2.myhost.com",
        "created_at": "2026-09-29 20:30:00",
        "expires_at": "2027-09-29 20:30:00"
      }
    ],
    "pagination": {
      "current_page": 1,
      "limit": 20,
      "total_records": 1,
      "total_pages": 1
    }
  }
}
POST

5.6. Cập Nhật Nameservers

/api/domain/nameservers

Thay đổi cụm Nameserver điều hướng cho tên miền của bạn sang máy chủ DNS khác (Cloudflare, cPanel, CyberPanel...).

Endpoint URL
POST https://lpkvps.cfd/api/domain/nameservers Content-Type: application/json
Request Parameters
Tham sốKiểuBắt buộcMô tả
domainstringBắt buộcTên miền cần đổi Nameserver (ví dụ: mybrandshop.com)
nameserver_1stringBắt buộcNameserver chính (ví dụ: duke.ns.cloudflare.com)
nameserver_2stringBắt buộcNameserver phụ (ví dụ: uma.ns.cloudflare.com)
tokenstringTuỳ chọnAPI Token nếu không truyền qua Header
Ví dụ cURL
curl -X POST "https://lpkvps.cfd/api/domain/nameservers" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "domain": "mybrandshop.com", "nameserver_1": "duke.ns.cloudflare.com", "nameserver_2": "uma.ns.cloudflare.com" }'
Response Mẫu (200 OK)
{
  "status": "success",
  "message": "Cập nhật Nameserver thành công!",
  "data": {
    "domain": "mybrandshop.com",
    "nameserver_1": "duke.ns.cloudflare.com",
    "nameserver_2": "uma.ns.cloudflare.com"
  }
}
GET

5.7. Chi Tiết Tên Miền & Bản Ghi DNS

/api/domain/details (Alias: /api/domain/dns)

Lấy toàn bộ thông số chi tiết của tên miền, trạng thái đơn hàng, ngày gia hạn và các bản ghi DNS cấu hình.

Endpoint URL
GET https://lpkvps.cfd/api/domain/details?domain={domain}
Query Parameters
Tham sốKiểuBắt buộcMô tả
domainstringBắt buộcTên miền cần tra cứu chi tiết
tokenstringTuỳ chọnAPI Token nếu không truyền qua Header
Ví dụ cURL
curl -X GET "https://lpkvps.cfd/api/domain/details?domain=mybrandshop.com" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"
Response Mẫu (200 OK)
{
  "status": "success",
  "data": {
    "order": {
      "id": 105,
      "domain": "mybrandshop.com",
      "status": "active",
      "created_at": "2026-09-29 20:30:00",
      "expires_at": "2027-09-29 20:30:00"
    },
    "nameservers": [
      { "host": "duke.ns.cloudflare.com" },
      { "host": "uma.ns.cloudflare.com" }
    ],
    "dns_records": []
  }
}

5.8. Code Mẫu Tích Hợp Domain API

PHP Class SDK & Node.js

Bộ mã nguồn mẫu hoàn chỉnh giúp lập trình viên và đại lý tích hợp toàn diện dịch vụ Tên miền vào hệ thống riêng.

5.8.1. PHP (Class SDK: classes/DichVuDarkDomainAPI.php)
<?php require_once __DIR__ . '/classes/DichVuDarkDomainAPI.php'; // Khởi tạo SDK với API Token cá nhân $domainApi = new DichVuDarkDomainAPI('YOUR_API_TOKEN', 'https://lpkvps.cfd'); // 1. Kiểm tra khả dụng & giá tên miền $check = $domainApi->checkDomain('domaincuaban.com'); echo "=== KIỂM TRA TÊN MIỀN ===\n"; print_r($check); // 2. Lấy bảng giá TLDs toàn hệ thống $pricing = $domainApi->getPricing(); echo "\n=== BẢNG GIÁ TLDS ===\n"; print_r($pricing); // 3. Đặt mua tên miền mới $order = $domainApi->buyDomain('domaincuaban.com', 1, 'ns1.myhost.com', 'ns2.myhost.com'); echo "\n=== KẾT QUẢ ĐĂNG KÝ TÊN MIỀN ===\n"; print_r($order); // 4. Lấy danh sách tên miền đã sở hữu $list = $domainApi->listDomains(1, 20); echo "\n=== DANH SÁCH TÊN MIỀN CỦA TÔI ===\n"; print_r($list); // 5. Cập nhật Nameservers $ns = $domainApi->updateNameservers('domaincuaban.com', 'duke.ns.cloudflare.com', 'uma.ns.cloudflare.com'); echo "\n=== CẬP NHẬT NAMESERVERS ===\n"; print_r($ns); // 6. Chi tiết tên miền & DNS $details = $domainApi->getDetails('domaincuaban.com'); echo "\n=== CHI TIẾT TÊN MIỀN ===\n"; print_r($details); ?>
5.8.2. Node.js (Axios)
const axios = require('axios'); class DichVuDarkDomainAPI { constructor(token, baseUrl = 'https://lpkvps.cfd') { this.token = token; this.client = axios.create({ baseURL: baseUrl, timeout: 30000, headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' } }); } async checkDomain(domain) { const res = await this.client.get('/api/domain/check', { params: { domain } }); return res.data; } async getPricing() { const res = await this.client.get('/api/domain/pricing'); return res.data; } async buyDomain(domain, period = 1, ns1 = null, ns2 = null) { const payload = { domain, period }; if (ns1) payload.nameserver_1 = ns1; if (ns2) payload.nameserver_2 = ns2; const res = await this.client.post('/api/domain/buy', payload); return res.data; } async listDomains(page = 1, limit = 20, search = '') { const res = await this.client.get('/api/domain/list', { params: { page, limit, search } }); return res.data; } async updateNameservers(domain, ns1, ns2) { const res = await this.client.post('/api/domain/nameservers', { domain, nameserver_1: ns1, nameserver_2: ns2 }); return res.data; } async getDetails(domain) { const res = await this.client.get('/api/domain/details', { params: { domain } }); return res.data; } } // === Ví dụ thực thi === (async () => { const api = new DichVuDarkDomainAPI('YOUR_API_TOKEN'); try { const check = await api.checkDomain('testbrandshop.com'); console.log('Kết quả kiểm tra:', check); } catch (err) { console.error('Lỗi gọi API:', err.response ? err.response.data : err.message); } })();
Đã sao chép!