Core Guide docs/api/README.md

01. 1API Overview — Một API cho toàn bộ vận hành doanh nghiệp

BizCity vận hành theo mô hình 1API: một API key, một gateway, nhưng mở ra toàn bộ nhánh nghiệp vụ AI cho doanh nghiệp.

1API được thiết kế cho doanh nghiệp muốn vận hành AI thực tế: dễ triển khai, dễ mở rộng và dễ kiểm soát chi phí.

Thay vì dùng nhiều công cụ rời rạc, doanh nghiệp có thể gom về một trục API chung để phục vụ content, CSKH, CRM, automation và phân tích nội bộ.

Trang này tập trung vào góc nhìn ra quyết định cho chủ doanh nghiệp và đội kỹ thuật nội bộ: dùng API nào cho bài toán nào, theo lộ trình nào.

Triết lý BizCity / BizCity Principles
  • Một API key dùng cho toàn bộ nhóm dịch vụ: LLM, Search, Video, Astrology, Marketplace, Automation, Commerce.
  • Tư duy triển khai theo bài toán kinh doanh trước, chọn branch API sau để tránh đầu tư dàn trải.
  • Dữ liệu, workflow và tri thức nội bộ nên được chuẩn hóa thành tài sản dài hạn của doanh nghiệp.
  • Kiến trúc mở giúp đội kỹ thuật nội bộ hoặc đối tác mở rộng theo nhu cầu mà không bị khóa cứng nền tảng.

Business Mapping Matrix

Bài toán doanh nghiệp Nhánh API Kết quả vận hành
Quản trị khách hàng và quy trình bán hàng Account/Billing + Marketplace + Twin CRM Chuẩn hóa quyền truy cập, vòng đời plugin và phễu vận hành
Sản xuất nội dung marketing tốc độ cao LLM + Image + Video + Automation Templates Tạo content đa định dạng theo quy trình có thể lặp lại
Khai thác tri thức doanh nghiệp theo ngữ cảnh Search + Rerank + LLM Tools Tăng độ chính xác khi truy xuất tri thức và ra quyết định
Tư vấn chuyên sâu theo hồ sơ con người Astrology + Astro Pro Charts Cá nhân hóa phân tích đội ngũ, hành vi và phối hợp
Thương mại hóa và mở khóa tính năng Commerce + License Hub Mua gói, cấp quyền, thanh toán và đồng bộ trạng thái sử dụng

Implementation Steps

  1. Xác định 1-2 bài toán ưu tiên trong 90 ngày (ví dụ: CSKH tự động, content vận hành, hoặc CRM funnel).
  2. Đăng ký API key, kết nối website doanh nghiệp và xác thực trạng thái entitlement.
  3. Chọn đúng branch API theo từng bài toán trong bộ 20 trang tài liệu để triển khai pilot.
  4. Sau pilot, mở rộng dần sang automation, báo cáo và quản trị đa kênh trên cùng một trục dữ liệu.

Kiểm tra kết nối API nhanh (health check)

bash
curl -X GET https://bizgpt.vn/wp-json/llm/router/v1/health

Kiểm tra quyền sử dụng gói hiện tại

bash
curl -X GET https://bizgpt.vn/wp-json/bizcity/v1/account/entitlement -H "Authorization: Bearer biz-YOUR_KEY"
Canonical Spec

docs/api/README.md

Notes for Public Deployment
  • Bộ 20 trang này được viết để chủ doanh nghiệp, đội vận hành và đội dev nội bộ cùng đọc chung một ngôn ngữ triển khai.
  • Nếu mới bắt đầu, nên đi theo thứ tự: Overview → Quick Start → branch API phù hợp với bài toán ưu tiên.

Mục tiêu triển khai cho doanh nghiệp

Doanh nghiệp chỉ cần cài plugin client, gắn API key, và dùng các page này làm chuẩn tích hợp để tự động mở rộng theo yêu cầu bởi team dev nội bộ, đối tác kỹ thuật, hoặc workflow code-assistant.

1 Platform · Full Digital Transformation Kết nối CRM, POS, omni-channel, AI automation, tạo ảnh, tạo video, content ops và analytics thành một nền tảng liền mạch.

Branch Query Examples (Copy nhanh cho dev)

LLM
GET /wp-json/llm/router/v1/models?purpose=chat
Search
POST /wp-json/search/router/v1/query {"query":"xu hướng ecom 2026"}
Video
POST /wp-json/video/router/v1/generate {"model":"kling-v2.6-pro","duration":5}
Astrology
POST /wp-json/bizcity/v1/astrology/western/natal {"dob":"1990-05-15"}
Marketplace
GET /wp-json/market/v1/catalog?page=1&per_page=20
Automation
GET /wp-json/bizcity/v1/automation-templates?category=facebook
Commerce
GET /wp-json/bizcity-commerce/v1/packages

20 Trang hướng dẫn API (direct links)

01. 1API Overview BizCity vận hành theo mô hình 1API: một API key, một gateway, nhưng mở ra toàn bộ nhánh nghiệp vụ AI cho doanh nghiệp. 02. Quick Start Playbook triển khai nhanh cho doanh nghiệp và đội dev: từ 0 đến chạy toàn bộ branch API trong 5 bước. 03. LLM Chat Branch #01 — Lõi giao tiếp AI cho toàn bộ hệ sinh thái. 04. LLM Tools Branch #02 — Trích xuất dữ liệu từ tài liệu, ảnh, âm thanh, video. 05. Search Branch #03 — Thu thập tri thức web thời gian thực cho tác vụ doanh nghiệp. 06. Video Branch #04 — Sinh video bất đồng bộ cho marketing, truyền thông, chiến dịch quảng cáo. 07. PiAPI Branch #05 — Mở rộng video/image workflow chuyên biệt. 08. Image Branch #06 — Sinh ảnh AI cho content ops, product studio, marketing campaigns. 09. Astrology Branch #07 + 07A — Cốt lõi chiêm tinh cho tư vấn chuyên gia và quản trị nhân sự. 10. Rerank Branch #08 — Tăng độ chính xác retrieval trước khi model tạo câu trả lời cuối. 11. Account & Billing Branch #09 — Quản trị hạn mức, chi phí, trạng thái truy cập và analytics sử dụng. 12. Google OAuth Branch #10 — Tập trung OAuth Google cho Calendar, Drive, Docs, Sheets theo mô hình hub. 13. Marketplace Branch #11 — Catalog plugin, download, update, phân phối module trong hệ sinh thái BizCity. 14. QR Templates Branch #12 — Quản trị thư viện template QR cho chiến dịch và điểm chạm khách hàng. 15. Image Templates Branch #13 — Thư viện template ảnh, sample và tài nguyên editor cho content studio. 16. QR Proxy Branch #14 — Endpoint tạo QR hot-link cho email, social post, landing page mà không cần Bearer. 17. Master Plans Branch #15 — Quản trị gói free/master_pro/master_premium và feature gating tập trung. 18. LLM Activity Branch #16 — Meter usage theo ngày và breakdown theo loại tác vụ. 19. Automation Templates Branch #17 — Chợ workflow template để nhân bản quy trình CRM, marketing, ops cho doanh nghiệp. 20. Commerce + License Branch #18 — Thanh toán gói và cấp entitlement tự động cho client plugin.