Đăng nhập
Cloud VPS Hosting Tên miền Proxy
Cloud VPS Hosting Tên miền Quản lý Proxy
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

Hệ thống API kết nối tự động dành cho Đại lý, Developer và Khách hàng tích hợp tra cứu, kiểm tra WHOIS, mua tên miền tự động và cập nhật Nameserver qua mã nguồn của bạn.

Xác thực tài khoản (Authentication)

API TOKEN / SECRET KEY

Bạn có thể gửi token qua Header Authorization: Bearer {token} hoặc truyền param token={token} trong request.
Hãy đăng nhập để xem API Token cá nhân của bạn hoặc tạo mới tại Hồ sơ cá nhân.

1. Kiểm tra khả năng đăng ký

GET / POST

Kiểm tra tên miền còn trống hay đã được đăng ký, tự động đồng bộ giá theo tỷ giá USD/VNĐ mới nhất từ hệ thống Registry quốc tế.
Lưu ý: API này là công khai (Public), không bắt buộc truyền Token khi kiểm tra.

GET https://dichvudark.vip/api/domain/check?domain={ten_mien}
Tham sốBắt buộcMô tả
domainBắt buộcTên miền đầy đủ cần kiểm tra (ví dụ: example.com, congty.vn)
curl -X GET "https://dichvudark.vip/api/domain/check?domain=example.com"
{
  "status": "success",
  "domain": "example.com",
  "tld": "com",
  "available": true,
  "price": 356000,
  "renew_price": 399000,
  "is_premium": false,
  "currency": "VND",
  "message": "Tên miền còn trống",
  "msg": "Tên miền còn trống"
}
👑 Tên miền Premium: Với các tên miền số đẹp, ngắn hoặc có giá trị thương hiệu cao, trường is_premium sẽ trả về true và price sẽ được định giá riêng theo biểu phí trực tiếp từ Registry quốc tế.

2. Bảng giá đuôi tên miền (TLD)

GET

Lấy danh sách các đuôi tên miền đang mở bán kèm giá đăng ký và giá gia hạn hàng năm trên hệ thống.

GET https://dichvudark.vip/api/domain/pricing
curl -X GET "https://dichvudark.vip/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_price": 356000, "renew_price": 399000 },
    { "tld": "net", "register_price": 447000, "renew_price": 447000 },
    { "tld": "xyz", "register_price": 81000, "renew_price": 499000 }
  ]
}

3. Đăng ký & Mua tên miền tự động

POST

Tạo đơn và tự động kích hoạt tên miền. Số dư tài khoản của bạn sẽ được trừ theo bảng giá.
Lưu ý: Bạn cần cập nhật đầy đủ Họ tên, Số điện thoại, Địa chỉ và Mã bưu chính tại Hồ sơ chủ thể trước khi gửi lệnh mua.

POST https://dichvudark.vip/api/domain/buy
Tham sốVị tríBắt buộcMô tả
AuthorizationHeaderBắt buộcBearer YOUR_API_TOKEN
domainBodyBắt buộcTên miền cần mua (ví dụ: brandmoi.com)
periodBodyTuỳ chọnThời hạn mua (1 - 10 năm), mặc định: 1
nameserver_1BodyTuỳ chọnNameserver cấp 1 (ví dụ: duke.ns.cloudflare.com)
nameserver_2BodyTuỳ chọnNameserver cấp 2 (ví dụ: uma.ns.cloudflare.com)
nameserversBodyTuỳ chọnDanh sách Nameserver tùy chỉnh (mảng JSON hoặc phân tách bằng dấu phẩy)
curl -X POST "https://dichvudark.vip/api/domain/buy" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "domain": "brandmoi.com", "period": 1, "nameserver_1": "duke.ns.cloudflare.com", "nameserver_2": "uma.ns.cloudflare.com" }'
☁️ Hướng dẫn Cloudflare Nameservers: Để quản lý DNS, tăng tốc CDN và kích hoạt SSL miễn phí, bạn có thể tạo tài khoản trên dash.cloudflare.com, thêm tên miền để lấy 2 địa chỉ Nameserver và truyền vào nameserver_1 & nameserver_2 ngay khi đặt mua.
{
  "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": "brandmoi.com",
    "tld": "com",
    "period": 1,
    "price": 356000,
    "unit_price": 356000,
    "renew_price": 399000,
    "is_premium": false,
    "nameservers": [
      "duke.ns.cloudflare.com",
      "uma.ns.cloudflare.com"
    ],
    "status": "active"
  }
}

4. Danh sách tên miền đã mua

GET / POST

Lấy danh sách tất cả các tên miền đã đăng ký trong tài khoản của bạn kèm trạng thái, ngày hết hạn và Nameservers.

GET https://dichvudark.vip/api/domain/list
Tham sốBắt buộcMô tả
tokenBắt buộcHoặc truyền qua header Authorization: Bearer {token}
page, limitTuỳ chọnPhân trang (mặc định: page=1, limit=20)
keywordTuỳ chọnTìm kiếm theo tên miền
curl -X GET "https://dichvudark.vip/api/domain/list?token=YOUR_API_TOKEN"
{
  "status": "success",
  "total": 1,
  "page": 1,
  "limit": 20,
  "data": [
    {
      "id": 1,
      "domain": "brandmoi.com",
      "tld": "com",
      "period": 1,
      "price": 356000,
      "status": "pending",
      "nameserver_1": "duke.ns.cloudflare.com",
      "nameserver_2": "uma.ns.cloudflare.com",
      "registered_at": "2026-09-29 20:30:00",
      "expires_at": "2027-09-29 20:30:00"
    }
  ]
}

5. Cập nhật Nameservers

POST

Thay đổi địa chỉ máy chủ định danh Nameservers (DNS) cho tên miền thuộc quyền sở hữu của bạn.

POST https://dichvudark.vip/api/domain/nameservers
Tham sốBắt buộcMô tả
domainBắt buộcTên miền của bạn
nameserver_1Bắt buộcĐịa chỉ Nameserver thứ nhất
nameserver_2Bắt buộcĐịa chỉ Nameserver thứ hai
curl -X POST "https://dichvudark.vip/api/domain/nameservers" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "domain": "brandmoi.com", "nameserver_1": "duke.ns.cloudflare.com", "nameserver_2": "uma.ns.cloudflare.com" }'
☁️ Xem hướng dẫn lấy Nameserver: Tại trang Quản lý tên miền, bạn có thể bấm vào nút "Hướng dẫn lấy Nameserver Cloudflare" trong popup chi tiết tên miền để xem hướng dẫn 4 bước trực quan.
{
  "status": "success",
  "msg": "Cập nhật nameserver thành công",
  "hosts": [
    "duke.ns.cloudflare.com",
    "uma.ns.cloudflare.com"
  ],
  "data": {
    "domain": "brandmoi.com",
    "nameserver_1": "duke.ns.cloudflare.com",
    "nameserver_2": "uma.ns.cloudflare.com"
  }
}

6. Chi tiết tên miền & Quản lý bản ghi DNS

GET / POST

Lấy trạng thái WHOIS trực tiếp từ nhà đăng ký, cấu hình Nameserver hiện tại và danh sách các bản ghi DNS (A, CNAME, TXT, MX) đang thiết lập.

GET https://dichvudark.vip/api/domain/details?domain={ten_mien}&token={token}
curl -X GET "https://dichvudark.vip/api/domain/details?domain=brandmoi.com&token=YOUR_API_TOKEN"
{
  "status": "success",
  "data": {
    "order": {
      "id": 1,
      "domain": "brandmoi.com",
      "status": "active"
    },
    "nameservers": [
      { "host": "duke.ns.cloudflare.com" },
      { "host": "uma.ns.cloudflare.com" }
    ],
    "dns_records": []
  }
}

7. Cập nhật bản ghi DNS (DNS Records)

POST

Thêm mới hoặc cập nhật toàn bộ các bản ghi DNS (A, CNAME, TXT, MX) cho tên miền của bạn. Hệ thống tự động đồng bộ lên cụm máy chủ Anycast DNS Registry và lưu trữ nội bộ.

POST https://dichvudark.vip/api/domain/dns
Tham sốVị tríBắt buộcMô tả
AuthorizationHeaderBắt buộcBearer YOUR_API_TOKEN
domainBodyBắt buộcTên miền của bạn (ví dụ: brandmoi.com)
itemsBodyBắt buộcMảng JSON các bản ghi DNS (type, name, content, ttl)
curl -X POST "https://dichvudark.vip/api/domain/dns" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "domain": "brandmoi.com", "items": [ { "type": "A", "name": "@", "content": "103.74.103.240", "ttl": 3600 }, { "type": "CNAME", "name": "www", "content": "brandmoi.com", "ttl": 3600 }, { "type": "TXT", "name": "@", "content": "v=spf1 ~all", "ttl": 3600 } ] }'
{
  "status": "success",
  "msg": "Đã cập nhật bản ghi DNS thành công",
  "message": "Đã cập nhật bản ghi DNS thành công",
  "domain": "brandmoi.com",
  "count": 3,
  "saved": [
    { "type": "A", "name": "@", "content": "103.74.103.240", "ttl": 3600 },
    { "type": "CNAME", "name": "www", "content": "brandmoi.com", "ttl": 3600 },
    { "type": "TXT", "name": "@", "content": "v=spf1 ~all", "ttl": 3600 }
  ]
}