/service/@id/builder/sites/@site/leadsLiên hệ và đơn hàng
Chỉ xem: liên hệ (kind=lead) hoặc đơn hàng (kind=order) khách để lại trên website, mới trước, lọc theo status, phân trang bằng page, per_page (tối đa 50) kèm meta. Liên hệ có name, phone, nội dung biểu mẫu (payload, khoá tuỳ mẫu website), source_page; đơn hàng có mã đơn, mặt hàng, phí giao, tổng tiền (null khi website không ghi giá), cách trả tiền, trạng thái. Xử lý liên hệ, đơn hàng làm trong TinoPage Builder (vé đăng nhập).
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) |
Query
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
kind | string | Tuỳ chọn | `lead` (liên hệ, mặc định) hoặc `order` (đơn hàng) |
status | string | Tuỳ chọn | Lọc theo trạng thái: `moi`, `da_lien_he`, `xac_nhan`, `dang_giao`, `hoan_tat`, `huy`; bỏ trống lấy tất cả |
page | int | Tuỳ chọn | Trang, mặc định 1 |
per_page | int | Tuỳ chọn | Số mục mỗi trang, mặc định 20, tối đa 50 |
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.