02. Quick Start — Cài plugin, gắn API, tích hợp mở rộng tự động

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.

Mô hình chuẩn: FE gọi same-origin proxy, PHP wrapper gọi lên BizCity Hub với Bearer biz-xxx.

Khi đã bám đúng pattern này, các app như VSCode extension flow hoặc antigravity automation có thể mở rộng chức năng theo từng endpoint mà không phá kiến trúc lõi.

Endpoints

Query Examples

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

const res = await fetch('https://bizgpt.vn/wp-json/llm/router/v1/health', {
  method: 'GET',
});
const data = await res.json();
console.log(data);

import requests
url = "https://bizgpt.vn/wp-json/llm/router/v1/health"
headers = {}
res = requests.get(url, headers=headers)
print(res.json())

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

const res = await fetch('https://bizgpt.vn/wp-json/bizcity/v1/account/entitlement', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer biz-YOUR_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests
url = "https://bizgpt.vn/wp-json/bizcity/v1/account/entitlement"
headers = {'Authorization': 'Bearer biz-YOUR_KEY'}
res = requests.get(url, headers=headers)
print(res.json())

curl -X GET "https://bizgpt.vn/wp-json/bizcity/v1/master/config" -H "Authorization: Bearer biz-YOUR_KEY"

const res = await fetch('https://bizgpt.vn/wp-json/bizcity/v1/master/config', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer biz-YOUR_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests
url = "https://bizgpt.vn/wp-json/bizcity/v1/master/config"
headers = {'Authorization': 'Bearer biz-YOUR_KEY'}
res = requests.get(url, headers=headers)
print(res.json())

Use Cases

• Khởi động nhanh một hệ thống CRM + content + omni channel trong cùng nền tảng WordPress.
• Tạo chuẩn kỹ thuật cho team outsource/dev nội bộ bám theo mà không lệch kiến trúc.
• Làm nền tảng để agent tự động hóa sinh code tích hợp theo endpoint chuẩn.

Implementation Steps

1. Cài plugin bizcity-twin-ai và kích hoạt trên site doanh nghiệp.
2. Vào phần LLM Settings để nhập bizcity_llm_gateway_url và bizcity_llm_api_key.
3. Tạo proxy REST cùng origin cho từng nghiệp vụ (chat/search/video/astro/billing).
4. Kiểm tra entitlement + quota trước khi gọi endpoint nặng (video, astro pro, automation).
5. Bật automation theo template hub để chuẩn hóa quy trình CRM, marketing, báo cáo.

Quick Start cURL

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

Mẫu proxy same-origin trên client plugin

register_rest_route('bizcity-twinchat/v1', '/account/entitlement', [
  'methods' => 'GET',
  'permission_callback' => '__return_true',
  'callback' => function() {
    // Call BizCity_LLM_Client::get_entitlement() and return fail-open payload
  },
]);

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.

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