POST
/service/@id/builder/sites/@site/unpublishTạm ngưng website
Gỡ website khỏi mạng, nội dung giữ nguyên (status về draft). Trả website. Đăng lại bằng Đăng website.
API TinoPage Builder · Cập nhật 26/10/2026Xem .md
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ả |
|---|---|---|---|
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.