/service/@id/builder/sitesTạo website bằng AI
Body JSON {intake}: AI chọn mẫu và viết nội dung theo thông tin cơ sở kinh doanh. HTTP 202: lượt tạo chạy nền 1–5 phút; hỏi Tiến độ tạo website tới khi state là done (site_id là website mới) hoặc failed. Mỗi tài khoản một lượt tại một thời điểm: 409 CREATION_IN_PROGRESS; hết số website: 409 LIMIT_EXCEEDED (details.key: sites); thiếu, sai ô: 422 VALIDATION_FAILED theo intake.<ô>; AI tạm dừng: 503 AI_UNAVAILABLE.
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 |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
intake | object | Bắt buộc | Thông tin cơ sở kinh doanh để AI chọn mẫu và viết nội dung: `business_name`, `industry`, `phone` bắt buộc; `address`, `city`, `services`, `hours`, `zalo`, `email` tuỳ chọn; độ dài tối đa ở [Bắt đầu với TinoPage Builder](/docs/builder-start#tao-website-bang-ai) |
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.