Nền tảng được hỗ trợ¶
Logidata API là một cổng cho nhiều nền tảng. Cùng một API key, cùng một cách xác thực, cùng một bộ mã lỗi — chỉ đổi tên nền tảng trong đường dẫn:
curl -H "X-API-Key: $KEY" -H "X-Account-Id: $ACC" \
"https://api.logidata.vn/v1/tiktok-ads/v1.3/report/integrated/get/?..."
curl -H "X-API-Key: $KEY" -H "X-Account-Id: $ACC" \
"https://api.logidata.vn/v1/shopee/api/v2/order/get_order_list?..."
Thêm một nền tảng vào hệ thống của bạn = thêm một kết nối trên portal và đổi một đoạn trong URL. Không phải đăng ký app developer mới, không phải dựng luồng OAuth mới, không phải học một cơ chế ký request mới.
Các nền tảng¶
| Nền tảng | Tên trong URL | 1 kết nối = |
|---|---|---|
| TikTok Ads / Business Center | tiktok-ads |
1 Business Center |
| TikTok Shop | tiktok-shop |
1 shop |
| Shopee (Seller) | shopee |
1 shop |
| Shopee Ads | shopee-ads |
1 shop |
| Google Ads | google-ads |
1 tài khoản quảng cáo |
| YouTube | youtube |
1 kênh |
| Google Search Console | google-search-console |
1 tài khoản Google |
| Google Sheets | google-sheets |
1 tài khoản Google |
| Nhanh.vn | nhanh |
1 gian hàng |
| Pancake POS | pancake |
1 shop |
| Shopee Affiliate | shopee-affiliate |
1 shop |
Kích hoạt theo yêu cầu
Phần lớn nền tảng trong bảng đã chạy production trên chính hạ tầng này — token, hàm ký request, luồng kéo dữ liệu đều là thứ Logidata vận hành hằng ngày cho khách hàng. Khi bạn cần một nền tảng, Logidata bật nó cho tài khoản của bạn; không có hàng chờ và không phải chờ một đợt phát hành nào.
Nhóm Google: kết nối kênh/tài khoản riêng đang trong giai đoạn thử nghiệm
Google Ads qua Link MCC dùng được ngay. Kết nối kênh YouTube của bạn, Google Search Console và Google Sheets đi qua một ứng dụng OAuth Google đang trong giai đoạn thử nghiệm.
Ngoài các sàn thương mại điện tử, gateway phủ luôn hai nền tảng vận hành phổ biến ở Việt Nam: Nhanh.vn (POS/quản lý bán hàng) và Pancake POS — cùng cách xác thực, cùng bộ mã lỗi. Facebook/Meta Ads hiện có ở tầng đồng bộ tự động; nếu bạn cần nó qua API gateway, hãy nói với Logidata.
Nhóm Google phủ bốn bề mặt qua cùng một lần đăng nhập Google: Google Ads, YouTube (kênh của bạn + Analytics, gồm doanh thu kênh với kênh đã bật kiếm tiền), Google Search Console (từ khoá thật trên website của bạn) và Google Sheets (đọc bảng tra do bạn quản).
Mức độ chi tiết của tài liệu¶
- TikTok Ads — đầy đủ: danh sách endpoint, từng tham số, ví dụ request và response thật.
- TikTok Shop, Shopee, Shopee Ads, Nhanh.vn, Pancake POS — nhóm dữ liệu lấy được, những khác biệt bạn cần biết trước khi thiết kế pipeline, và những gì Logidata làm hộ.
- Google Ads, YouTube, Google Search Console, Google Sheets — mô hình dữ liệu, allowlist và các ràng buộc (quota YouTube, whitelist GAQL, quy định lưu trữ) cần biết khi lập kế hoạch.
Điểm chung của mọi nền tảng¶
Dù gọi nền tảng nào, bốn điều sau luôn đúng:
1. Response trả nguyên văn của nền tảng. Không có lớp đổi tên trường nào ở giữa. Code đang chạy trực tiếp với nền tảng chỉ cần đổi base URL và header xác thực. (Nếu bạn muốn một lược đồ thống nhất giữa các nền tảng, đó là việc của tầng chuẩn hoá — cố ý tách riêng, không nhét vào API thô.)
2. Xác thực luôn là hai header. X-API-Key + X-Account-Id, không đổi giữa
các nền tảng. Xem Xác thực.
3. Chỉ đọc. Mỗi nền tảng có một allowlist đường dẫn, mặc định chỉ gồm
endpoint đọc dữ liệu. Đường ghi (create, update, delete) bị chặn ngay
tại Logidata — request không bao giờ chạm tới nền tảng. Đây là lựa chọn có chủ ý:
một lỗi trong code của bạn không thể đổi ngân sách hay tắt campaign qua hạ tầng
Logidata.
4. Phần khó nhất do Logidata gánh. Khác biệt lớn nhất giữa các nền tảng nằm ở xác thực, và bạn không phải chạm vào bất kỳ phần nào của nó:
| Nền tảng | Cơ chế thật của nền tảng | Bạn phải làm gì |
|---|---|---|
| TikTok Ads | Header Access-Token dài hạn |
Không |
| TikTok Shop | Ký HMAC-SHA256 từng request + cipher riêng theo shop |
Không |
| Shopee / Shopee Ads / Shopee Affiliate | Ký HMAC-SHA256 từng request + partner_id/partner_key riêng theo từng app (3 app = 3 cặp khoá) + refresh_token hết hạn định kỳ |
Không |
| Google Ads | OAuth2 refresh token + developer_token + ngôn ngữ truy vấn GAQL |
Không |
| YouTube / Search Console / Sheets | OAuth2 chủ tài khoản, access token sống 1 giờ + đếm quota YouTube theo unit | Không |
| Nhanh.vn | POST form kèm appId + businessId + accessToken, tham số gói trong chuỗi JSON |
Không |
| Pancake POS | api_key gắn thẳng vào query string của mọi request |
Không |
Logidata giữ token, ký request, và làm mới token trước khi hết hạn. Bạn gửi request thường và nhận response thường.
Đơn vị bán ra: kết nối¶
Hạn mức của gói tính theo kết nối, không theo nền tảng. Một kết nối là một
thực thể có token riêng: 1 Business Center, 1 shop, 1 tài khoản quảng cáo, 1 kênh
YouTube, hoặc 1 tài khoản Google. youtube và youtube-analytics dùng chung một
kết nối.
Shopee: mỗi app tính một kết nối riêng
shopee, shopee-ads và shopee-affiliate là ba partner app khác nhau
của Shopee, cấp quyền riêng biệt. Một shop Shopee dùng cả ba tính 3 kết
nối, không phải 1 — chọn gói theo số app Shopee bạn thực sự dùng, không
theo số shop.
Mọi gói — kể cả bản dùng thử — mở toàn bộ nền tảng. Gói chỉ khác nhau ở hạn mức tháng, tần suất và số kết nối. Xem Gói dùng thử và bảng gói.
Nền tảng bạn cần chưa có trong danh sách?¶
Kiến trúc gateway được thiết kế cho nhiều nền tảng ngay từ đầu — thêm một nền tảng là viết một lớp provider, không phải dựng lại hệ thống. Nếu bạn đang cần một nền tảng chưa có trong bảng, hãy nói với Logidata kèm khối lượng dự kiến.