Branch #15 docs/api/15-master-plans.md

17. Master Plans API

Branch #15 — Quản trị gói free/master_pro/master_premium và feature gating tập trung.

Endpoints

GET
https://bizgpt.vn/wp-json/bizcity/v1/master/config

Cấu hình plan hiện tại

Auth: Bearer

GET
https://bizgpt.vn/wp-json/bizcity/v1/master/plans

Danh sách plan công khai

Auth: Public

GET
https://bizgpt.vn/wp-json/bizcity/v1/master/health

Health check

Auth: Public

Method Path Auth Mô tả
GET https://bizgpt.vn/wp-json/bizcity/v1/master/config Bearer Cấu hình plan hiện tại
GET https://bizgpt.vn/wp-json/bizcity/v1/master/plans Public Danh sách plan công khai
GET https://bizgpt.vn/wp-json/bizcity/v1/master/health Public Health check

Query Examples

GET Cấu hình plan hiện tại
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())
GET Danh sách plan công khai
curl -X GET "https://bizgpt.vn/wp-json/bizcity/v1/master/plans"
const res = await fetch('https://bizgpt.vn/wp-json/bizcity/v1/master/plans', {
  method: 'GET',
});
const data = await res.json();
console.log(data);
import requests
url = "https://bizgpt.vn/wp-json/bizcity/v1/master/plans"
headers = {}
res = requests.get(url, headers=headers)
print(res.json())
GET Health check
curl -X GET "https://bizgpt.vn/wp-json/bizcity/v1/master/health"
const res = await fetch('https://bizgpt.vn/wp-json/bizcity/v1/master/health', {
  method: 'GET',
});
const data = await res.json();
console.log(data);
import requests
url = "https://bizgpt.vn/wp-json/bizcity/v1/master/health"
headers = {}
res = requests.get(url, headers=headers)
print(res.json())

Use Cases

  • Map tính năng plugin theo cấp gói rõ ràng.
  • Hiển thị pricing page đồng bộ toàn hệ thống.
  • Đảm bảo entitlement nhất quán giữa client sites.

Implementation Steps

  1. Load config plan lúc boot app.
  2. Ẩn/hiện feature dựa trên entitlement keys.
  3. Cache config để giảm call lặp.

Quick Start cURL

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

docs/api/15-master-plans.md