Doanh nghiệp (Business Manager) người kết nối thuộc về

User Businesses

GET/{version}/me/businessesGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/me/businesses

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

Các doanh nghiệp (Business Manager) mà nick Facebook đã kết nối là thành viên — nguồn lấy business_id cho các API Doanh nghiệp / Danh mục.

Trả MỌI doanh nghiệp nick là thành viên, kể cả doanh nghiệp không chứa tài sản đã nối với 360 — lọc theo tài sản bằng GET /act_…?fields=business hoặc /{page_id}?fields=business.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/me/businesses

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	act_123456789 hoặc 1234567890	Tài sản Facebook brand đã nối với 360: tài khoản quảng cáo (act_<id> hoặc <id>), Page id hoặc Pixel id — lấy ở GET /v1/platforms. Có thể bỏ khi đường dẫn đã chứa act_<id> / page id của brand.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
version	path	string	Có	v25.0
platform_shop_id	query	string	Có	act_543733994517908	BẮT BUỘC là tài khoản QC `act_…` đã nối — `me` khi đó là nick người kết nối. Truyền Id Trang thì `me` là Trang → lỗi 100 "nonexisting field (businesses)".
fields	query	string	Không	id,name,verification_status,created_time,link,permitted_roles	Trường cần lấy (mặc định chỉ id, name).
limit	query	int	Không	25	Số doanh nghiệp mỗi trang.
after	query	string	Không		`paging.cursors.after` của trang trước.

Phân trang

Lặp khi có paging.next: thêm after = paging.cursors.after.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/me/businesses?platform_shop_id=act_543733994517908&fields=id%2Cname%2Cverification_status%2Ccreated_time&limit=25" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/facebook/v25.0/me/businesses",
    params={
        "platform_shop_id": "act_543733994517908",
        "fields": "id,name,verification_status,created_time",
        "limit": 25
    },
    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/facebook/v25.0/me/businesses');
for (const [k, v] of Object.entries({"platform_shop_id":"act_543733994517908","fields":"id,name,verification_status,created_time","limit":25})) 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/facebook/v25.0/me/businesses' . '?' . http_build_query(['platform_shop_id' => 'act_543733994517908', 'fields' => 'id,name,verification_status,created_time', 'limit' => 25]);
$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 Facebook)

Tên	Kiểu	Mẫu	Mô tả
data	object[]		Doanh nghiệp.
id	string	183780650684749	Id doanh nghiệp (`business_id`).
name	string		Tên doanh nghiệp.
verification_status	string	not_verified	`verified` · `not_verified` · `pending` · `failed` …
created_time	string	2024-03-28T03:33:33+0000	ISO 8601, UTC.
link	string		Link trang quản lý doanh nghiệp.
permitted_roles	string[]		Vai trò của nick trong doanh nghiệp.
paging	object		Chỉ có khi còn trang.

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Doanh nghiệp (Business Manager) ở trang nền tảng
Tạo API key (tick kênh Facebook)
Gọi theo ví dụ ở trên

Doanh nghiệp (Business Manager) người kết nối thuộc về — API Facebook