List of ad accounts — API Pancake POS

get /shops/{SHOP_ID}/ads_manager/ad_accounts

GET/shops/{SHOP_ID}/ads_manager/ad_accountsGọi qua 360: GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/ads_manager/ad_accounts

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

Danh sách tài khoản quảng cáo Facebook đã liên kết vào Quản lý quảng cáo của Pancake POS: mã, tên, trạng thái, tiền tệ, lần đồng bộ cuối.

Chỉ có dữ liệu khi cửa hàng dùng tính năng Quản lý quảng cáo của Pancake. Gọi thật trên cửa hàng thử (chưa dùng): HTTP 200, 0 tài khoản.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/ads_manager/ad_accounts

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	1234567	SHOP_ID đã nối — có thể bỏ khi đường dẫn có /shops/{SHOP_ID}.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
SHOP_ID	path	integer	Có	1234567	Mã cửa hàng đã nối với 360.
page	query	int	Không	1
page_size	query	int	Không	30

Phân trang

Tăng page tới total_pages.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/ads_manager/ad_accounts?page=1&page_size=30" \
  -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_pos/shops/1234567/ads_manager/ad_accounts",
    params={
        "page": 1,
        "page_size": 30
    },
    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_pos/shops/1234567/ads_manager/ad_accounts');
for (const [k, v] of Object.entries({"page":1,"page_size":30})) 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_pos/shops/1234567/ads_manager/ad_accounts' . '?' . http_build_query(['page' => 1, 'page_size' => 30]);
$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 POS)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object[]		TKQC.
id	string		Mã TKQC.
name	string
account_status	int	1	`1` hoạt động · `2` vô hiệu · `3` chưa thanh toán · `7` chờ xét rủi ro · `8` chờ quyết toán · `9` ân hạn · `100` chờ đóng · `101` đã đóng.
currency	string	VND
is_business	bool		TK doanh nghiệp / cá nhân.
sync_succeed_at	string		Lần đồng bộ thành công cuối.
tags	string[]
page_number / page_size / total_pages / total_entries	int

Mẫu phản hồi

{
  "success": true,
  "data": [],
  "page_size": 30,
  "total_pages": 1,
  "page_number": 1,
  "total_entries": 0
}

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Bán hàng & quảng cáo ở trang nền tảng
Tạo API key (tick kênh Pancake POS)
Gọi theo ví dụ ở trên