# Khang Baby LIVE KPI Workers API

Tài liệu dành cho agent và nhà phát triển của Khang Baby LIVE KPI chạy trên Cloudflare Workers.

## Khám phá

- [OpenAPI 3.1](https://sellerkhangbaby.online/openapi.json)
- [OAuth protected-resource metadata](https://sellerkhangbaby.online/.well-known/oauth-protected-resource)
- [Google OAuth 2.0 discovery](https://accounts.google.com/.well-known/openid-configuration)
- [llms.txt](https://sellerkhangbaby.online/llms.txt)

## Xác thực và quyền

Gửi token qua header `Authorization: Bearer <token>`. API chấp nhận Firebase ID token hiện có của ứng dụng hoặc Google OAuth 2.0 access token có scope `openid email`. Email phải được Google xác minh và phải thuộc tài khoản Admin của dự án. Mọi endpoint nghiệp vụ hiện đều là Admin-only.

## Nhóm API

- `kpi.read`: đọc trạng thái kết nối và dung lượng.
- `kpi.sync`: đồng bộ LIVE, đơn, hoàn và Affiliate.
- `kpi.connections.manage`: bắt đầu ủy quyền TikTok và làm mới token.

Các tên trên mô tả quyền nghiệp vụ trong tài liệu; OAuth token tối thiểu chỉ cần `openid email`, còn Worker tiếp tục áp dụng allowlist Admin cho từng request.