get /pages/{page_id}/statistics/pages
GET/public_api/v1/pages/{page_id}/statistics/pagesGọi qua 360: GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/pages
Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.
Mô tả API
Thống kê tương tác của trang THEO GIỜ: số tin / bình luận của khách, số tin / bình luận trang trả lời, khách mới, hội thoại mới, hội thoại có tương tác, SĐT thu được. Cộng các giờ ra tổng ngày / kỳ — dùng cho báo cáo hiệu quả trực page và tỉ lệ xin được số.
- Thiếu since →
{"message":"since is required!","success":false}; khoảng > 1 năm →{"message":"Statistics date range cannot exceed one calendar year","success":false}(HTTP 200). - since / until là Unix UTC nhưng
hourtrả theo giờ của trang: gửi 00:00–23:59 giờ VN (since = 1793120400, until = 1793206799) nhận các mốc2026-10-28T04:00:00…2026-10-28T21:00:00. - Chỉ có giờ phát sinh số liệu: thử thật 1 ngày → 13 mốc, 31 ngày → 319 mốc. Muốn tổng ngày / kỳ thì tự cộng.
Request
Địa chỉ
GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/pages
Xác thực & gian hàng
| Tên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 107896751234567 | page_id đã nối — có thể bỏ (lấy từ đường dẫn). |
Tham số request
| Tên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| page_id | path | string | Có | 107896751234567 | Mã trang đã nối với 360. |
| since | query | timestamp | Có | 1793120400 | Từ (Unix giây, UTC). |
| until | query | timestamp | Có | 1793206799 | Đến (Unix giây, UTC). Khoảng tối đa 1 năm. |
Ví dụ request
curl -s "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages?since=1793120400&until=1793206799" \ -H "Authorization: Bearer $KEY"
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.get(
"https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages",
params={
"since": 1793120400,
"until": 1793206799
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages');
for (const [k, v] of Object.entries({"since":1793120400,"until":1793206799})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'GET',
headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());PHP
<?php $key = 'q360_live_...'; // khóa API của brand $url = 'https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/pages' . '?' . http_build_query(['since' => 1793120400, 'until' => 1793206799]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]); $res = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); echo $status, "\n", $res;
Response
Tham số phản hồi (nguyên của Pancake Chat)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| success | bool | true | `false` + `message` khi lỗi (HTTP vẫn 200). |
| data | object[] | Mỗi phần tử một GIỜ có hoạt động (giờ không có gì bị bỏ qua), cũ trước. | |
| hour | string | 2026-10-28T20:00:00 | Mốc giờ — GIỜ CỦA TRANG (trang VN = giờ VN), dù since / until là UTC. |
| customer_inbox_count | int | 1 | Tin nhắn của khách. |
| customer_comment_count | int | 0 | Bình luận của khách. |
| page_inbox_count | int | 104 | Tin trang gửi. |
| page_comment_count | int | 0 | Bình luận trang trả lời. |
| new_customer_count | int | 0 | Khách mới. |
| new_inbox_count | int | 0 | Hội thoại inbox mới. |
| inbox_interactive_count | int | 1 | Hội thoại inbox có tương tác. |
| phone_number_count | int | 0 | SĐT thu được. |
| uniq_phone_number_count | int | 0 | SĐT không trùng. |
| today_uniq_website_referral / today_website_guest_referral | int | 0 | Khách đến từ website (không trùng / lượt). |
Mẫu phản hồi
{
"success": true,
"data": [
{
"hour": "2026-10-28T04:00:00",
"new_customer_count": 0,
"customer_inbox_count": 1,
"customer_comment_count": 0,
"page_inbox_count": 1,
"page_comment_count": 0,
"phone_number_count": 0,
"inbox_interactive_count": 1,
"new_inbox_count": 0,
"uniq_phone_number_count": 0,
"today_uniq_website_referral": 0,
"today_website_guest_referral": 0
},
{
"hour": "2026-10-28T20:00:00",
"new_customer_count": 0,
"customer_inbox_count": 0,
"customer_comment_count": 0,
"page_inbox_count": 104,
"page_comment_count": 0,
"phone_number_count": 0,
"inbox_interactive_count": 0,
"new_inbox_count": 0,
"uniq_phone_number_count": 0,
"today_uniq_website_referral": 0,
"today_website_guest_referral": 0
}
]
}
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Thống kê ở trang nền tảng
- Tạo API key (tick kênh Pancake Chat)
- Gọi theo ví dụ ở trên