POST
/v1/service/@service_id/dns/@zone_id/recordsThêm bản ghi DNS
Thêm một bản ghi vào vùng DNS.
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 dns: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
dns:writeSửa bản ghi DNS
Tham số
Tham số đường dẫn
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
service_id | string | Bắt buộc | ID dịch vụ DNS |
zone_id | string | Bắt buộc | ID vùng DNS |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
name | string | Tuỳ chọn | Record name |
ttl | integer | Tuỳ chọn | Record ttl |
priority | integer | Tuỳ chọn | Priority of the record |
type | string | Tuỳ chọn | Record type |
content | string | Tuỳ chọn | Contents of the record |
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 dns: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.