/service/@id/builder/loginVé đăng nhập một lần
Trả 201 {url, expires_at}: link đăng nhập dùng một lần, hiệu lực 120 giây, vào trang quản lý (target: me) hoặc trình sửa của một website (target: editor, site_id). Mở link ngay cho chính chủ dịch vụ, không lưu, không gửi qua kênh khác. Dịch vụ đang tạm ngưng vẫn cấp vé (vào chỉ xem); dịch vụ đã chấm dứt trả 403 ACCOUNT_TERMINATED.
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ả |
|---|---|---|---|
target | string | Tuỳ chọn | `me` (trang quản lý, mặc định) hoặc `editor` (trình sửa website) |
site_id | string | Tuỳ chọn | ID website (UUID) cần mở; bỏ trống: website cũ nhất của tài khoản |
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.