TrolyPage Public API v1
TrolyPage Public API cho phép doanh nghiệp và đối tác tự động hóa CRM, Inbox, AI Agents, Knowledge RAG, Commerce, Booking, Automation và Báo cáo qua chuẩn HTTP REST + OpenAPI 3.1.2.
Base URLs
Phần tiêu đề “Base URLs”| Môi trường | Base URL | Token prefix |
|---|---|---|
| Production | https://api.trolypage.com/v1 |
tp_live_* / tp_oa_* |
| Sandbox | https://sandbox-api.trolypage.com/v1 |
tp_test_* |
| Visitor Client Chat | https://api.trolypage.com/v1/client-sessions/* |
tp_cs_* |
Đặc tả hợp đồng tải về
Phần tiêu đề “Đặc tả hợp đồng tải về”Chuẩn giao thức cốt lõi
Phần tiêu đề “Chuẩn giao thức cốt lõi”- Envelope:
{"data": ..., "meta": {"request_id": "..."}}cho single item và{"data": [...], "meta": {"has_more": bool, "next_cursor": "..."}, "links": {"next": "..."}}cho collection. - Errors: Chuẩn RFC 9457
application/problem+jsonkèmcode,request_idvàretryable. - Optimistic Concurrency: Mọi
PATCHyêu cầuContent-Type: application/merge-patch+jsonvàIf-Match: "rev_N". ThiếuIf-Matchtrả428; lệch revision trả412. - Idempotency: Các lệnh
POSThỗ trợ headerIdempotency-Key(lưu receipt tối thiểu 7 ngày, xung đột payload trả409). - Tiền tệ: Dùng object số nguyên
{"amount_minor": 250000, "currency": "VND"}(không dùng số thực float).
