Công cụ Tên miền

Công cụ Tên miền: Danh sách, Tra cứu, Gợi ý, Phân tích, Chuyển đổi

Tổng quan

Công cụ Tên miền: Danh sách, Tra cứu, Gợi ý, Phân tích, Chuyển đổi

  • Danh sách: Danh sách đuôi tên miền & bảng giá, Danh sách TLD toàn cầu
  • Tra cứu: Tra cứu DNS hàng loạt, Tra cứu DNS record, WHOIS Lookup
  • Gợi ý: Gợi ý tên miền bằng AI, Gợi ý tên miền theo keyword
  • Phân tích: Crawl thông tin website, Phân tích website
  • Chuyển đổi: Chuyển đổi Punycode sang Unicode, Chuyển đổi Unicode sang Punycode
  • Authentication: API key Bearer token qua header Authorization: Bearer YOUR_API_KEY

Base URL: https://developers-dev.inet.vn/api/gateway/v1

Response wrapper: Tất cả response được wrap trong { success, data, meta }. Response schema bên dưới mô tả nội dung field data. Xem chi tiết tại Response Format.


Danh sách

Danh sách đuôi tên miền & bảng giá

GET /domain/suffixes

Lấy danh sách tất cả đuôi tên miền (TLD) mà iNET đang hỗ trợ đăng ký, kèm bảng giá đăng ký, gia hạn và thông tin khuyến mãi.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/suffixes"

Danh sách TLD toàn cầu

GET /domain/tlds

Lấy danh sách tất cả Top-Level Domains (TLD) trên thế giới, bao gồm WHOIS server, registry URL và khả năng đăng ký.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/tlds"

Tra cứu

Tra cứu DNS hàng loạt

POST /domain/bulk-lookup

Tra cứu DNS records cho nhiều host cùng lúc. Hỗ trợ type: lookup, ipv4, ns.

Request Body

TrườngKiểuBắt buộcMô tả
listarrayDanh sách host + type cần tra cứu
list[].hoststringHostname cần tra cứu
list[].typestringLoại record
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"list":[{}]}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/bulk-lookup"

Tra cứu DNS record

POST /domain/lookup

Tra cứu DNS records cho tên miền. Hỗ trợ các loại: lookup (default), ipv4, ipv6, cname, mx, ns, soa, srv, txt.

Có thể chỉ định DNS server cụ thể (vd: 8.8.8.8) hoặc dùng server mặc định.

Request Body

TrườngKiểuBắt buộcMô tả
typestringLoại DNS record
domainstringTên miền cần tra cứu
serverstringKhôngDNS server (vd: 8.8.8.8). Bỏ trống để dùng mặc định
defaultbooleanKhôngSử dụng DNS server mặc định
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"lookup","domain":"example_domain","server":"8.8.8.8","default":true}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/lookup"

Response

JSON
{
  "data": [
    "example"
  ],
  "status": "success"
}
TrườngKiểuMô tả
dataarrayDanh sách kết quả DNS
statusstring

WHOIS Lookup

GET /domain/whois/{domain}

Tra cứu thông tin WHOIS của tên miền. Trả về registrar, nameserver, ngày đăng ký, ngày hết hạn, trạng thái, và thông tin registrant.

Query parameter tùy chọn: ?refreshCache=true để bỏ qua cache.

Tham sốVị tríKiểuBắt buộcMô tả
domainpathstringTên miền cần tra cứu (vd: inet.vn, google.com)
refreshCachequerybooleanKhôngBỏ qua cache, tra cứu trực tiếp
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/whois/inet.vn"

Response

JSON
{
  "code": "example_code",
  "DNSSEC": "example_DNSSEC",
  "status": [
    "example"
  ],
  "message": "example_message",
  "registrar": "example_registrar",
  "domainName": "example_domainName",
  "nameServer": [
    "example"
  ],
  "creationDate": "example_creationDate",
  "expirationDate": "example_expirationDate",
  "registrantName": "example_registrantName"
}
TrườngKiểuMô tả
codestringMã trạng thái (0 = thành công)
DNSSECstring
statusarray
messagestring
registrarstring
domainNamestring
nameServerarray
creationDatestring
expirationDatestring
registrantNamestring

Gợi ý

Gợi ý tên miền bằng AI

POST /domain/ai-suggest

Sử dụng AI để gợi ý tên miền phù hợp dựa trên keyword. Trả về danh sách tên miền kèm giá đăng ký.

Request Body

TrườngKiểuBắt buộcMô tả
tldsarrayKhôngDanh sách TLD mong muốn (vd: ["com", "vn"])
messagestringKeyword hoặc mô tả để gợi ý tên miền (vd: coffee shop)
maxLengthintegerKhôngĐộ dài tối đa tên miền (mặc định 15)
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tlds":["example"],"message":"coffee shop","maxLength":1}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/ai-suggest"

Gợi ý tên miền theo keyword

GET /domain/suggest/{query}

Gợi ý các tên miền liên quan dựa trên keyword. Trả về danh sách tên miền có chứa hoặc liên quan đến từ khóa.

Tham sốVị tríKiểuBắt buộcMô tả
querypathstringKeyword để gợi ý tên miền (vd: cafe, coffee)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/suggest/cafe"

Phân tích

Crawl thông tin website

GET /domain/crawl-website

Crawl trang web và lấy thông tin cơ bản: title, meta, thời gian tải.

Path parameter: /crawler/{domain}

Tham sốVị tríKiểuBắt buộcMô tả
domainpathstringTên miền cần crawl
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/crawl-website"

Response

JSON
{
  "title": "example_title",
  "hostname": "example_hostname",
  "domainName": "example_domainName",
  "executeTime": 1
}
TrườngKiểuMô tả
titlestring
hostnamestring
domainNamestring
executeTimenumberThời gian xử lý (ms)

Phân tích website

GET /domain/analyze-website

Phân tích công nghệ sử dụng trên website (technology detection).

Path parameter: /analyzer/{domain}

Tham sốVị tríKiểuBắt buộcMô tả
domainpathstringTên miền website cần phân tích
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/analyze-website"

Chuyển đổi

Chuyển đổi Punycode sang Unicode

POST /domain/unicode

Chuyển đổi tên miền Punycode (dạng xn--) về dạng Unicode đọc được.

Request Body

TrườngKiểuBắt buộcMô tả
punycodeValuestringTên miền Punycode (vd: xn--c-phng-bya.vn)
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punycodeValue":"xn--c-phng-bya.vn"}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/unicode"

Chuyển đổi Unicode sang Punycode

POST /domain/punycode

Chuyển đổi tên miền Unicode (có dấu tiếng Việt) sang định dạng Punycode để sử dụng trong DNS.

Request Body

TrườngKiểuBắt buộcMô tả
unicodeValuestringTên miền Unicode (vd: cà-phê.vn)
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unicodeValue":"cà-phê.vn"}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/punycode"