API miền

Liệt kê tất cả các tên miền

Trả lại các miền đăng ký trong tài khoản của bạn, 25 mỗi trang. Danh sách không có bộ lọc.

Cần quyền: domains:list

Ví dụ về yêu cầu

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

Ví dụ về câu trả lời

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

Các trường phản hồi

Nhập chi tiết miền

Trả lại một đối tượng miền với các trường ở trên.

Cần quyền: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Mã trạng thái phản hồi

Tìm kiếm miền

Kiểm tra xem tên có sẵn trong khoảng 20 phần mở rộng phổ biến (com, net, org, io, dev, co, app, ai và nhiều hơn nữa), cộng thêm phần mở rộng bạn gõ nếu nó không nằm trong số đó. Kết quả bắt đầu với sự trùng khớp chính xác, sau đó là tên có sẵn, sau đó là những tên đã được sử dụng.

Cần quyền: domains:search

Các tham số thân yêu cầu

Ví dụ về yêu cầu

curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'

import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

Ví dụ về câu trả lời

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

Giá là số tiền trong USD cho một năm và là 0 cho tên không có sẵn. Giá được hiển thị là minh họa.

Mã trạng thái phản hồi

Đăng ký tên miền mới

Đăng ký một tên miền và thu phí theo phương thức thanh toán đã lưu. Sự sẵn có và giá sẽ được kiểm tra với nhà đăng ký một lần nữa ngay trước khi thu phí. Thông tin liên lạc của người đăng ký sẽ được lấy từ hồ sơ tài khoản của bạn. Nếu nhà đăng ký từ chối đăng ký sau khi thu phí, tiền sẽ được trả lại.

Cần quyền: domains:register (được cấp bởi miền: *)

Các tham số thân yêu cầu

curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

Ví dụ về câu trả lời

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

Mã trạng thái phản hồi

Tăng cấp miền

Thời hạn miền và tính phí renewal_ price cho mỗi năm theo phương thức thanh toán đã lưu.

Cần quyền: domains:renew

Các tham số thân yêu cầu

curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

Mã trạng thái phản hồi

Cập nhật máy phục vụ tên

Đặt máy phục vụ tên miền của miền tại cơ quan đăng ký và trả lại đối tượng miền cập nhật. Để quản lý DNS với API DNS, dùng ns1. vps.org, ns2. vps.org và ns3. vps.org và tạo một vùng cho miền.

Cần quyền: domains:update

Các tham số thân yêu cầu

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

Mã trạng thái phản hồi

Bật hay tắt tự động cập nhật

Đặt auto_ renew và trả về đối tượng miền cập nhật. Gửi được bật như một boolean JSON: bất kỳ chuỗi không rỗng nào, bao gồm chuỗi false, bật tự động cập nhật.

Cần quyền: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Mã trạng thái phản hồi

Ghi chú

• API không thể xóa một tên miền, chuyển một tên miền vào, hoặc thay đổi sự riêng tư WHOIS hoặc khóa chuyển đổi. Việc chuyển đổi và xóa có sẵn trong bảng điều khiển tại admin.vps.org.
• Các ghi chép DNS cho một tên miền được quản lý bằng DNS API. API quản lý DNS