/service/@id/builder/sites/@site/leadsContacts and orders
Read only: contacts (kind=lead) or orders (kind=order) left on the website, newest first, filtered by status, paged with page, per_page (at most 50) and meta. A contact has name, phone, the form content (payload, keys depend on the website's form) and source_page; an order has its code, items, shipping fee, total (null when the website shows no price), payment method and status. Handle contacts and orders in TinoPage Builder (sign-in ticket).
A TinoPage Builder service route: call it with the service owner's sign-in token; the /v1 gateway (app tokens, personal tokens) does not expose TinoPage Builder yet. See Getting started with TinoPage Builder.
Authentication
Send the token in the header Authorization:
Authorization: Bearer <token>
Tokens that can call it: the TinoPage Builder service owner's sign-in token (the tino.vn client area token).
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | int | Required | TinoPage Builder service ID |
site | string | Required | Website ID (UUID, `id` in the website list) |
Query
| Name | Type | Required | Description |
|---|---|---|---|
kind | string | Optional | `lead` (contacts, default) or `order` (orders) |
status | string | Optional | Filter by status: `moi`, `da_lien_he`, `xac_nhan`, `dang_giao`, `hoan_tat`, `huy`; omit for all |
page | int | Optional | Page, default 1 |
per_page | int | Optional | Items per page, default 20, at most 50 |
Response
Sample built from the TinoPage Builder API (Tino relays the answer as is inside data); values are examples.
Error codes
| Error code | Description |
|---|---|
404 · SERVICE_NOT_FOUND, invalid method | The service does not belong to the signed-in account, or is not TinoPage Builder. |
400 · INVALID_REQUEST | An ID, domain, query or body has the wrong shape; details.field names the field. |
403 · ACCOUNT_SUSPENDED | The service is suspended: writes are blocked, GET still works. |
404 · RESOURCE_NOT_FOUND | The website or domain is not in the account. |
409 · LIMIT_EXCEEDED | A limit of the purchased service is used up; details.key names the limit. |
422 · VALIDATION_FAILED | Invalid data; details lists the fields. |
502, 503 · NETWORK_ERROR, NOT_CONFIGURED… | The connection between Tino and TinoPage Builder is interrupted: a Tino-side error, not a token problem. Retry later. |
Errors look like {"error": ["<CODE>"], "message", "details", "request_id"}; every code is in Getting started with TinoPage Builder.