POST
/v1/domain/orderĐặt mua tên miền
Tạo đơn đăng ký hoặc chuyển tên miền riêng lẻ. Kiểm tra tên miền còn trống trước (POST /v1/domain/lookup), nếu không đơn có thể bị huỷ.
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ố
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
name | string | Tuỳ chọn | Domain name |
years | string | Tuỳ chọn | Number of years |
action | string | Tuỳ chọn | register|transfer |
tld_id | string | Tuỳ chọn | TLD id |
pay_method | integer | Tuỳ chọn | Payment method ID |
epp | string | Tuỳ chọn | EPP Transfer code, required when transfering some domains |
nameservers | array | Tuỳ chọn | Optional array with 2 - 4 nameservers that you want to use |
registrant | integer | Tuỳ chọn | Optional contact ID to use for registrant contact this domain |
admin | integer | Tuỳ chọn | Optional contact ID to use for admin contact this domain |
tech | integer | Tuỳ chọn | Optional contact ID to use for tech contact this domain |
billing | integer | Tuỳ chọn | Optional contact ID to use for billing contact this domain |
data | array | Tuỳ chọn | Addditional data required for some TLDs |
aff_id | integer | Tuỳ chọn | Affiliate ID |
Phản hồi
Chưa có mẫu thật: route thay đổi dữ liệu thật hoặc tài khoản thử không có dữ liệu cho route này. Câu trả lời là một đối tượng JSON; lỗi theo dạng chung ở Gọi API Tino.
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.