Bỏ qua để đến nội dung

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.

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_*
  • 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+json kèm code, request_id và retryable.
  • Optimistic Concurrency: Mọi PATCH yêu cầu Content-Type: application/merge-patch+json và If-Match: "rev_N". Thiếu If-Match trả 428; lệch revision trả 412.
  • Idempotency: Các lệnh POST hỗ trợ header Idempotency-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).