GBA · API V1.1

一個聯盟入口，連結更多企業網站。

具備雙向 API 介接架構：讀取 BSGAI 核准企業名錄、提供 GBA 公開企業資料接口，亦可由具授權的企業金鑰送交中央審核。

STATUS: checking… · Preview/Netlify manual upload may show offline. Static HTML never contains an API key. / 預覽或純靜態上傳不會啟用後端。

1 · Public business directory / 公開企業名錄

GET returns published local GBA profiles together with centrally approved BSGAI GBA companies. 未核准的企業不會公開。

GET /api/v1/companies?locale=zh-TW&limit=20
GET /api/v1/status
GET /api/v1/enterprise/:slug

Response: {"items":[],"total":0,"connected":false,"sources":{"local":0,"bsgai":0}}

2 · Internal administrator / GBA 內部管理

Admin operations require GBA_ADMIN_TOKEN (min. 32 characters) set only in Netlify environment variables; never embed it in frontend code. 管理後台讀寫獨立 GBA 企業資料，不會自動篡改 BSGAI 主平台。

GET    /api/v1/admin/companies
POST   /api/v1/admin/companies
DELETE /api/v1/admin/companies/:slug
Header: X-GBA-Admin-Token: <SECRET>

Open Admin Portal ↗

3 · BSGAI V9.8 central gateway / 中央 API

BSGAI 官方 V9.8 API：GET /api/v1/alliances/GBA/companies、GET /api/v1/alliances/GBA/companies/:slug。資料送審為 POST /api/v1/alliances/GBA/companies/:slug/sync，需該企業的 bsgai_... Bearer key。中央回覆 202 僅代表待審，並非已核准公開。

本網站可在後台授權下呼叫 POST /api/v1/admin/sync。必須配置 BSGAI_GATEWAY_ORIGIN、BSGAI_COMPANY_SLUG、BSGAI_COMPANY_API_KEY。這組金鑰只對一間公司有效；其他企業須各自擁有授權帳號，不能共用金鑰。

4 · Integration scope / 接入範圍

GBA 公開 API 已可供主平台或第三方讀取，惟 BSGAI 主平台若要自動讀取 GBA 新 API，還須在主平台另行配置對接，不能單方面假設已雙向同步。GBA 的管理後台、中央企業審核、表單通知及資料存取均須在正式 Netlify Functions 環境驗證。

產品 products 送交中央 V9.8 的欄位應為語言文字映射，而非 SKU JSON 陣列；本網站不提供支付、托管、證券或代幣交易服務。

首頁

5 · Pageview aggregation API / 瀏覽與導覽次數加總

GBA V1.1 可讓 BSGAI 後端定期讀取本站計數，但不會自行修改 BSGAI 主站。統計的是「各頁載入及導覽點擊事件」，非不重複訪客；Netlify Blobs 的高併發計數亦可能低估。

GET  /api/v1/counter
GET  /api/v1/counter?page=home
POST /api/v1/counter
Content-Type: application/json
Body: {"page":"home"}

回傳 totalViews 為本站所有可計數頁面與導覽事件加總、pages 為各單元分項。BSGAI 主站若要合併統計，應在主站安全後端讀取 GET API，避免把單純導覽點擊誤作獨立訪客。