/service/@id/builder/sites/@site/domainsGắn tên miền riêng
Gắn một tên miền vào website: HTTP 201, tên miền ở trạng thái pending kèm bản ghi DNS khách cần đặt (dns). Với tên miền gốc, dns có thêm CNAME cho www. Website chưa đăng trả 409 SITE_NOT_PUBLISHED; hết số tên miền: 409 LIMIT_EXCEEDED (details.key: domains_per_site); tên miền đang gắn website khác: 409 DOMAIN_TAKEN; không phải tên miền: 422 VALIDATION_FAILED.
Route của dịch vụ TinoPage Builder: gọi bằng token đăng nhập của chủ dịch vụ; gateway /v1 (token ứng dụng, token cá nhân) chưa mở TinoPage Builder. Xem Bắt đầu với TinoPage Builder.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token đăng nhập của chủ dịch vụ TinoPage Builder (token khu vực khách hàng tino.vn).
Tham số
Tham số đường dẫn
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
id | int | Bắt buộc | ID dịch vụ TinoPage Builder |
site | string | Bắt buộc | ID website (UUID, `id` ở danh sách website) |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
hostname | string | Bắt buộc | Tên miền cần gắn (1–253 ký tự), vd `example.vn` hoặc `banhang.example.vn`; TinoPage Builder tự bỏ `https://`, đường dẫn, chữ hoa |
idempotency_key | string | Tuỳ chọn | 8–64 ký tự `A-Za-z0-9._:-`: gửi lại cùng khoá và cùng nội dung thì nhận lại kết quả lần trước, không làm lại |
Phản hồi
Mẫu dựng theo API của TinoPage Builder (Tino chuyển tiếp nguyên câu trả lời trong data), giá trị là ví dụ.
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
404 · SERVICE_NOT_FOUND, invalid method | Dịch vụ không phải của tài khoản đang đăng nhập, hoặc không phải TinoPage Builder. |
400 · INVALID_REQUEST | ID, tên miền, query hoặc body sai dạng; details.field chỉ trường. |
403 · ACCOUNT_SUSPENDED | Dịch vụ đang tạm ngưng: chặn thao tác ghi, GET vẫn dùng được. |
404 · RESOURCE_NOT_FOUND | Website hoặc tên miền không có trong tài khoản. |
409 · LIMIT_EXCEEDED | Hết hạn mức của dịch vụ đã mua; details.key chỉ hạn mức. |
422 · VALIDATION_FAILED | Dữ liệu sai; details liệt kê theo trường. |
502, 503 · NETWORK_ERROR, NOT_CONFIGURED… | Kết nối giữa Tino và TinoPage Builder gián đoạn: lỗi phía Tino, không phải lỗi token. Thử lại sau. |
Lỗi có dạng {"error": ["<CODE>"], "message", "details", "request_id"}; mọi mã lỗi ở Bắt đầu với TinoPage Builder.