API Tích Hợp Tên Miền (Domain API)

Hệ thống API tự động hóa tra cứu, đăng ký tên miền & quản lý DNS/Nameservers chuẩn Reseller & Agency

Protocol v2.0 Tra cứu tên miền

Xác thực Bearer Token

Gửi Header Authorization: Bearer YOUR_TOKEN hoặc tham số token=... trong mọi request cần xác thực.

Khấu trừ tự động

Khi đăng ký tên miền mới, hệ thống tự động trừ số dư ví tài khoản theo bảng giá TLD niêm yết.

Nameserver Cloudflare

Mặc định gán cặp Cloudflare NS tốc độ cao (hoặc truyền cặp NS tùy chỉnh của riêng bạn khi tạo đơn).

5.1. Cơ chế xác thực Domain API

API Tên miền sử dụng xác thực bằng API Token cá nhân. Bạn có thể truyền token theo 2 cách:

Cách 1: HTTP Header (Khuyên dùng) Authorization: Bearer YOUR_API_TOKEN
Cách 2: Query Param / JSON Body token: YOUR_API_TOKEN

5.2. Kiểm tra tên miền & Tra cứu giá

PUBLIC API (Không cần Token)

Kiểm tra khả dụng, giá mua năm đầu và giá gia hạn cho bất kỳ tên miền nào.

GET https://host.tunthui.shop/api/domain/check?domain=domaincuaban.com
Response mẫu khi tên miền khả dụng:
{
  "status": "success",
  "domain": "domaincuaban.com",
  "tld": "com",
  "available": true,
  "price": 290000,
  "renew_price": 320000,
  "is_premium": false,
  "currency": "VND",
  "message": "Tên miền còn trống"
}

5.3. Bảng giá toàn bộ TLDs

PUBLIC API

Lấy toàn bộ danh sách đuôi mở rộng (.com, .net, .vn, .xyz...), giá đăng ký và giá gia hạn.

GET https://host.tunthui.shop/api/domain/pricing 
{
  "status": "success",
  "data": {
    "com": { "tld": "com", "register": 356000, "renew": 399000 },
    "net": { "tld": "net", "register": 447000, "renew": 447000 },
    "xyz": { "tld": "xyz", "register": 81000, "renew": 499000 }
  },
  "list": [
    { "tld": "com", "register": 356000, "renew": 399000 },
    { "tld": "net", "register": 447000, "renew": 447000 }
  ]
}

5.4. Đặt mua / Đăng ký tên miền tự động

YÊU CẦU TOKEN

Thực hiện đăng ký tên miền ngay lập tức từ số dư tài khoản.

POST https://host.tunthui.shop/api/domain/buy
JSON Payload mẫu:
{
  "domain": "mybrandshop.com",
  "period": 1,
  "nameserver_1": "duke.ns.cloudflare.com",
  "nameserver_2": "uma.ns.cloudflare.com",
  "privacy_protection": 1
}

5.5 - 5.7. Quản lý & Cập nhật Nameservers

GET https://host.tunthui.shop/api/domain/list?page=1&limit=20
Danh sách tên miền đang sở hữu
POST https://host.tunthui.shop/api/domain/nameservers
Cập nhật NS1, NS2 sang Cloudflare/cPanel
GET https://host.tunthui.shop/api/domain/details?domain=mybrandshop.com
Chi tiết thông số & bản ghi DNS

5.8. Code mẫu tích hợp (PHP SDK) 

<?php
// Khởi tạo SDK Tên Miền
$api = new DichVuDarkDomainAPI('YOUR_API_TOKEN');

// 1. Kiểm tra tình trạng & giá tên miền
$check = $api->checkDomain('domaincuaban.com');
print_r($check);

// 2. Lấy bảng giá TLDs
$pricing = $api->getPricing();
print_r($pricing);

// 3. Đăng ký tên miền tự động
$order = $api->buyDomain('domaincuaban.com', 1, 'ns1.example.com', 'ns2.example.com');
print_r($order);
Hỗ trợ