Quản lý Tên miền — Portal

Quản lý Tên miền: Danh sách, Thông tin chi tiết, Tra cứu, Kiểm tra, Quản lý

Tổng quan

Quản lý Tên miền: Danh sách, Thông tin chi tiết, Tra cứu, Kiểm tra, Quản lý

Danh sách: Danh sách DNS records, Danh sách tên miền, Lịch sử thao tác tên miền
Thông tin chi tiết: Chi tiết tên miền
Tra cứu: Danh sách tên miền .vn tự do hàng ngày
Kiểm tra: Kiểm tra tên miền khả dụng, Kiểm tra tên miền khả dụng hàng loạt, Kiểm tra trạng thái bản khai của tên miền
Quản lý: Cập nhật DNS records, Cập nhật Nameserver
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 DNS records

GET /domain/{domainId}/record

Lấy danh sách DNS records của tên miền có hỗ trợ phân trang.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainId`	path	integer	Có	ID tên miền
`page`	query	integer	Không	Số trang (bắt đầu từ 1)
`pageSize`	query	integer	Không	Số bản ghi mỗi trang
`q`	query	string	Không	Tìm kiếm theo tên record (vd: www, _dmarc)

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

Response

JSON

{
  "size": 1,
  "number": 1,
  "content": [
    {
      "id": 1,
      "ttl": 1,
      "data": "1.2.3.4",
      "name": "@",
      "type": "example_type",
      "dClass": "example_dClass",
      "domainId": 1,
      "priority": 1,
      "createdDate": "example_createdDate"
    }
  ],
  "totalPages": 1,
  "totalElements": 1,
  "numberOfElements": 1
}

Trường	Kiểu	Mô tả
`size`	integer	Số bản ghi mỗi trang
`number`	integer	Trang hiện tại (0-based)
`content`	array	Danh sách DNS records
`content[].id`	integer	ID record
`content[].ttl`	integer	TTL (giây)
`content[].data`	string	Giá trị record (vd: 1.2.3.4)
`content[].name`	string	Tên record (vd: @, www, _dmarc)
`content[].type`	string	Loại: A, AAAA, CNAME, MX, TXT, SRV...
`content[].dClass`	string	DNS class (luôn là IN)
`content[].domainId`	integer	ID tên miền
`content[].priority`	integer	Priority (chỉ có với MX record)
`content[].createdDate`	string	Ngày tạo (dd/MM/yyyy HH:mm)
`totalPages`	integer	Tổng số trang
`totalElements`	integer	Tổng số bản ghi
`numberOfElements`	integer	Số bản ghi trang hiện tại

Danh sách tên miền

GET /domain

Lấy danh sách tên miền của khách hàng, hỗ trợ phân trang và lọc theo trạng thái, tên miền.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`name`	query	string	Không	Lọc theo tên miền (để trống = tất cả)
`status`	query	string	Không	Lọc theo trạng thái (vd: active,trial,suspended)
`page`	query	integer	Không	Số trang (bắt đầu từ 1)
`pageSize`	query	integer	Không	Số bản ghi mỗi trang

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

Response

JSON

{
  "size": 1,
  "number": 1,
  "content": [
    {
      "id": 1,
      "name": "example.vn",
      "status": "example_status",
      "suffix": "vn",
      "contract": "example_contract",
      "issueDate": "example_issueDate",
      "expireDate": "example_expireDate",
      "registrant": "example_registrant",
      "verifyStatus": "example_verifyStatus"
    }
  ],
  "totalPages": 1,
  "totalElements": 1
}

Trường	Kiểu	Mô tả
`size`	integer	Số bản ghi mỗi trang
`number`	integer	Trang hiện tại (0-based)
`content`	array	Danh sách tên miền
`content[].id`	integer	ID tên miền
`content[].name`	string	Tên miền (vd: example.vn)
`content[].status`	string	Trạng thái: active, expired, trial, suspended
`content[].suffix`	string	Đuôi tên miền (vd: vn)
`content[].contract`	string	Trạng thái hợp đồng: approved, pending
`content[].issueDate`	string	Ngày đăng ký (dd/MM/yyyy HH:mm)
`content[].expireDate`	string	Ngày hết hạn
`content[].registrant`	string	Tên chủ sở hữu
`content[].verifyStatus`	string	Trạng thái xác minh: verified, undefined
`totalPages`	integer	Tổng số trang
`totalElements`	integer	Tổng số bản ghi

Lịch sử thao tác tên miền

GET /domain/{domainId}/log

Lấy lịch sử thay đổi DNS records, cập nhật nameserver và các thao tác khác trên tên miền.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainId`	path	integer	Có	ID tên miền
`page`	query	integer	Không	Số trang (bắt đầu từ 1)
`pageSize`	query	integer	Không	Số bản ghi mỗi trang
`actionName`	query	string	Không	Lọc theo loại thao tác (VD: update-record)
`fromDate`	query	string	Không	Từ ngày (dd/MM/yyyy)
`toDate`	query	string	Không	Đến ngày (dd/MM/yyyy)

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

Response

JSON

{
  "content": [
    {
      "id": 1,
      "actionName": "update-record",
      "createdDate": "example_createdDate",
      "description": "example_description"
    }
  ],
  "totalPages": 1,
  "totalElements": 1
}

Trường	Kiểu	Mô tả
`content`	array	Danh sách log
`content[].id`	integer	ID log
`content[].actionName`	string	Loại thao tác (vd: update-record, change-password)
`content[].createdDate`	string	Thời gian thực hiện (dd/MM/yyyy HH:mm)
`content[].description`	string	Mô tả chi tiết thao tác
`totalPages`	integer	Tổng số trang
`totalElements`	integer	Tổng số bản ghi

Thông tin chi tiết

Chi tiết tên miền

GET /domain/{domainId}

Lấy thông tin chi tiết tên miền theo ID. Trả về thông tin đăng ký, nameserver, trạng thái, ngày hết hạn.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainId`	path	integer	Có	ID tên miền

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

Response

JSON

{
  "id": 1,
  "name": "example.vn",
  "nsList": [
    {
      "id": 1,
      "hostname": "ns1.inet.vn"
    }
  ],
  "status": "example_status",
  "suffix": "vn",
  "contract": "example_contract",
  "issueDate": "example_issueDate",
  "renewDate": "example_renewDate",
  "expireDate": "example_expireDate",
  "registrant": "example_registrant",
  "verifyStatus": "example_verifyStatus",
  "domainStatuses": [
    {
      "status": "ok"
    }
  ]
}

Trường	Kiểu	Mô tả
`id`	integer	ID tên miền
`name`	string	Tên miền (vd: example.vn)
`nsList`	array	Danh sách nameserver
`nsList[].id`	integer
`nsList[].hostname`	string	Hostname (vd: ns1.inet.vn)
`status`	string	Trạng thái: active, expired, trial, suspended
`suffix`	string	Đuôi tên miền (vd: vn)
`contract`	string	Trạng thái hợp đồng: approved, pending
`issueDate`	string	Ngày đăng ký (dd/MM/yyyy HH:mm)
`renewDate`	string	Ngày gia hạn gần nhất
`expireDate`	string	Ngày hết hạn
`registrant`	string	Tên chủ sở hữu
`verifyStatus`	string	Trạng thái xác minh: verified, undefined
`domainStatuses`	array	Trạng thái EPP
`domainStatuses[].status`	string	EPP status (vd: ok, clientTransferProhibited)

Tra cứu

Danh sách tên miền .vn tự do hàng ngày

GET /domain/list-domainvn-available

Danh sách tên miền .vn tự do hàng ngày, hỗ trợ lọc theo tên, đuôi miền, độ tuổi tên miền.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainName`	query	string	Không	Từ khóa tìm kiếm tên miền (vd: abc)
`sldName`	query	string	Không	Lọc theo đuôi miền (vd: vn, com.vn, edu.vn)
`labelLengthLte`	query	integer	Không	Độ dài tối đa phần label tên miền
`domainAgeGte`	query	integer	Không	Tuổi tên miền tối thiểu (năm)
`fromDeletedDate`	query	string	Không	Từ ngày hết hạn (ISO 8601, vd: 2026-03-04T17:00:00.000Z)
`toDeletedDate`	query	string	Không	Đến ngày hết hạn (ISO 8601, vd: 2026-03-04T17:00:00.000Z)
`page`	query	integer	Không	Số trang (bắt đầu từ 1)
`pageSize`	query	integer	Không	Số bản ghi mỗi trang

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

Response

JSON

{
  "size": 1,
  "number": 1,
  "content": [
    {
      "id": 1,
      "sldName": "vn",
      "domainAge": 1,
      "domainName": "tpmt.vn",
      "domainType": "example_domainType",
      "deletedDate": "example_deletedDate",
      "domainLabel": "tpmt",
      "creationTime": "example_creationTime",
      "idnDomainName": "example_idnDomainName"
    }
  ],
  "totalPages": 1,
  "totalElements": 1,
  "numberOfElements": 1
}

Trường	Kiểu	Mô tả
`size`	integer	Số bản ghi mỗi trang
`number`	integer	Trang hiện tại (0-based)
`content`	array	Danh sách tên miền sắp hết hạn
`content[].id`	integer	ID tên miền
`content[].sldName`	string	Đuôi tên miền (vd: vn, com.vn)
`content[].domainAge`	integer	Tuổi tên miền (năm)
`content[].domainName`	string	Tên miền đầy đủ (vd: tpmt.vn)
`content[].domainType`	string	Loại tên miền: ASCII hoặc IDN
`content[].deletedDate`	string	Ngày hết hạn (ISO 8601)
`content[].domainLabel`	string	Phần label (trước đuôi miền, vd: tpmt)
`content[].creationTime`	string	Thời điểm xuất hiện trong hệ thống (ISO 8601)
`content[].idnDomainName`	string	Tên miền dạng IDN/Unicode (null nếu ASCII)
`totalPages`	integer	Tổng số trang
`totalElements`	integer	Tổng số bản ghi
`numberOfElements`	integer	Số bản ghi trang hiện tại

Kiểm tra

Kiểm tra tên miền khả dụng

GET /domain/check-available

Kiểm tra xem tên miền khả dụng để đăng ký hay không. Trả về trạng thái available/unavailable.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`name`	query	string	Có	Tên miền cần kiểm tra (vd: mywebsite.vn)

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/check-available?name=mywebsite.vn"

Response

JSON

{
  "status": [
    "example"
  ],
  "available": "available",
  "domainName": "example_domainName",
  "nameServer": [
    "example"
  ],
  "availability": "example_availability"
}

Trường	Kiểu	Mô tả
`status`	array
`available`	string
`domainName`	string
`nameServer`	array
`availability`	string

Kiểm tra tên miền khả dụng hàng loạt

POST /domain/bulk-check-available

Kiểm tra nhiều tên miền có thể đăng ký không cùng lúc. Trả về trạng thái available/unavailable cho từng tên miền trong danh sách.

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`domains`	array	Có	Danh sách tên miền cần kiểm tra (vd: ["inet.vn", "mysite.com"])

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains":["example"]}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/bulk-check-available"

Kiểm tra trạng thái bản khai của tên miền

POST /domain/profile-status/check

Kiểm tra và cập nhật trạng thái bản khai đăng ký tên miền của khách hàng. Không cần body.

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/domain/profile-status/check"

Response

JSON

{
  "trialDay": 1,
  "contactID": true,
  "ownerView": true,
  "renewTrial": true,
  "removeRecord": true,
  "customerEmail": "example_customerEmail"
}

Trường	Kiểu	Mô tả
`trialDay`	integer	Số ngày trial còn lại
`contactID`	boolean	Trạng thái contact ID
`ownerView`	boolean	Xem theo quyền chủ sở hữu
`renewTrial`	boolean	Có gia hạn trial không
`removeRecord`	boolean	Có xóa record không
`customerEmail`	string	Email khách hàng

Quản lý

Cập nhật DNS records

PATCH /domain/{domainId}/record

Thêm hoặc xóa DNS records cho tên miền.

Thêm record: action = ACTION_ADD (không cần id)
Xóa record: action = ACTION_DELETE (cần id record, lấy từ GET /domains/{domainId}/records với phân trang)
Sửa record: gửi 2 items — 1 ACTION_DELETE record cũ + 1 ACTION_ADD record mới

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainId`	path	integer	Có	ID tên miền

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`recordList`	array	Có	Danh sách thao tác trên DNS records. Mỗi item là 1 thao tác thêm hoặc xóa.
`recordList[].id`	integer	—	ID record (bắt buộc khi xóa)
`recordList[].ttl`	string	—	Time to live — giây (VD: 300)
`recordList[].data`	string	Có	Giá trị (VD: 1.2.3.4 cho A, example.vn cho CNAME)
`recordList[].name`	string	Có	Tên record (VD: @ = root, www, _dmarc)
`recordList[].type`	string	Có	Loại record: A, AAAA, CNAME, MX, TXT, SRV
`recordList[].action`	string	Có	ACTION_ADD = thêm, ACTION_DELETE = xóa
`recordList[].domainId`	integer	Có	ID tên miền (giống path param {id})

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

Response

JSON

{
  "id": 1,
  "name": "example.vn",
  "status": "example_status",
  "recordList": [
    {
      "id": 1,
      "ttl": 1,
      "data": "1.2.3.4",
      "name": "@",
      "type": "example_type",
      "priority": 1,
      "createdDate": "example_createdDate"
    }
  ]
}

Trường	Kiểu	Mô tả
`id`	integer	ID tên miền
`name`	string	Tên miền (vd: example.vn)
`status`	string	Trạng thái tên miền
`recordList`	array	Danh sách DNS records sau khi cập nhật
`recordList[].id`	integer	ID record
`recordList[].ttl`	integer	TTL (giây)
`recordList[].data`	string	Giá trị record (vd: 1.2.3.4)
`recordList[].name`	string	Tên record (vd: @, www, _dmarc)
`recordList[].type`	string	Loại: A, AAAA, CNAME, MX, TXT, SRV...
`recordList[].priority`	integer	Priority (chỉ cho MX)
`recordList[].createdDate`	string	Ngày tạo (dd/MM/yyyy HH:mm)

Cập nhật Nameserver

PATCH /domain/{domainId}/nameserver

Thay đổi nameserver của tên miền.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`domainId`	path	integer	Có	ID tên miền

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`nsList`	array	Có	Danh sách nameserver mới
`nsList[].hostname`	string	Có	Hostname nameserver (VD: ns1.inet.vn)

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

Response

JSON

{
  "id": 1,
  "name": "example.vn",
  "nsList": [
    {
      "id": 1,
      "domainId": 1,
      "hostname": "ns3.inet.vn",
      "domainName": "example_domainName"
    }
  ],
  "status": "example_status",
  "suffix": "id.vn",
  "modifiedDate": "example_modifiedDate",
  "domainStatuses": [
    {
      "id": 1,
      "status": "ok",
      "domainId": 1
    }
  ]
}

Trường	Kiểu	Mô tả
`id`	integer	ID tên miền
`name`	string	Tên miền (vd: example.vn)
`nsList`	array	Nameserver sau khi cập nhật
`nsList[].id`	integer	ID nameserver
`nsList[].domainId`	integer	ID tên miền
`nsList[].hostname`	string	Hostname (vd: ns3.inet.vn)
`nsList[].domainName`	string	Tên miền
`status`	string	Trạng thái: active, expired, suspended
`suffix`	string	Đuôi tên miền (vd: id.vn)
`modifiedDate`	string	Ngày cập nhật (dd/MM/yyyy HH:mm)
`domainStatuses`	array	Trạng thái EPP
`domainStatuses[].id`	integer
`domainStatuses[].status`	string	EPP status (vd: ok, clientTransferProhibited)
`domainStatuses[].domainId`	integer