POST
/v1/domain/@id/regQuản lý nameserver riêng
Đăng ký, sửa hoặc xoá nameserver riêng (glue record) của tên miền; chọn thao tác bằng action:
registerNameServer: đăng ký glue record mới (cầnnameserver,ip)modifyNameServer: đổi IP của glue record (cầnnameserver,oldip,newip)deleteNameServer: xoá glue record (cầnnameserver)
API v1 · Cập nhật 21/10/2026Xem .md
Gọi qua gateway https://api.tino.vn/v1 bằng token có quyền domains:write; xem Gọi API Tino.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token ứng dụng (tinoat_, Đăng nhập bằng Tino) hoặc token API cá nhân (tinopat_).
Scopes
domains:writeQuản lý tên miền
Tham số
Tham số đường dẫn
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
id | string | Bắt buộc | ID tên miền |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
action | string | Tuỳ chọn | Operation: registerNameServer, modifyNameServer, deleteNameServer |
nameserver | string | Tuỳ chọn | Full nameserver hostname |
ip | string | Tuỳ chọn | IP address for the nameserver – required for registerNameServer |
oldip | string | Tuỳ chọn | Current IP address – required for modifyNameServer |
newip | string | Tuỳ chọn | New IP address – required for modifyNameServer |
Phản hồi
Câu trả lời JSON của route, giữ nguyên dạng của UserAPI (Dữ liệu cá nhân). Mẫu thật từ tài khoản thử, đã che dữ liệu cá nhân; mảng và chuỗi dài được rút gọn (… N more item(s), … N more line(s)).
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
401 · invalid_token | Token sai, hết hạn hoặc đã bị thu hồi. |
403 · insufficient_scope | Token không có quyền domains:write. |
403 · ip_not_allowed | Token API cá nhân gọi từ IP ngoài danh sách giới hạn. |
Lỗi nghiệp vụ của route thường là HTTP 200 kèm {"error": ["<code>"]}; xem mã lỗi chung.