獨立企業網站、ERP／CRM 系統與 BSGAI 全球展覽館之間的整合介面。
GBA、HWA、SGREA、SGAA 共用相同的公開企業資料介面、十國語言及企業授權審核流程。本功能保留舊版其他 API；不會自動公開未經核准的資料。
| API | 功能 |
|---|---|
GET /api/v1/alliances | 四大聯盟資訊和公開企業筆數 |
GET /api/v1/alliances/GBA/companies?locale=en | 範例：GBA 名錄，可替換 HWA / SGREA / SGAA |
GET /api/v1/alliances/SGAA/companies/企業slug | 公開的 SGAA 企業詳細資料 |
POST /api/v1/alliances/SGAA/companies/企業slug/sync | 使用企業服務端 API Key 送審資料；中央核准後才會發布 |
打開四聯盟 API 管理中心 ↗ · 完整 API 參考文件
公開 GET 允許跨站讀取；POST 不允許前端保管秘密金鑰。四聯盟共用舊有 1,000 家展示上限，不是每盟獨立 1,000 家。
每家公司使用固定的 slug，以不同企業帳號、Cookie Session 與 API Key 隔離資料。所有更新採中央審核後發佈，防止未授權變更公開資訊或擔保記錄。V9.7 延用 V9.6 的 Netlify Blobs 企業儲存機制，暫維持 1,000 家的現有名錄容量限制。
| 操作 | API 路徑 | 身分驗證 |
|---|---|---|
| 讀取公開資料 | GET /.netlify/functions/company-api?op=public&slug=abc | 不需要 |
| 登入及企業內部操作 | /company-portal/ | 公司帳號、HttpOnly Cookie |
| 系統服務端送審資料 | POST /.netlify/functions/company-api?op=update&slug=abc | 該公司 API Key |
| 核准發佈、重設企業帳號 | /.netlify/functions/company-admin?slug=abc | 中央 BSGAI 管理員 Token |
GET https://YOUR-DOMAIN/.netlify/functions/company-api?op=public&slug=example-enterprise回傳 JSON {"company": {...}, "profileUrl": "/members/example-enterprise", "version":"9.7"}。僅公開已核准上架公司資料。不啟用跨來源 CORS，外站應透過企業伺服器代理讀取或使用公開企業專頁連結；公開瀏覽器呼叫是否可用取決於同源政策。
企業後台可核發最多三組獨立 API Key，只會顯示一次。以下指令應只在企業受保護的伺服器環境執行，不可把 Key 寫在網頁 HTML 或前端 JavaScript。
curl -X POST 'https://YOUR-DOMAIN/.netlify/functions/company-api?op=update&slug=example-enterprise' \
-H 'Authorization: Bearer bsgai_YOUR_PRIVATE_KEY' \
-H 'Content-Type: application/json' \
--data '{"name":{"zh":"示例企業","en":"Example Co."},
"website":"https://example.com",
"description":{"zh":"公司介紹"}}'收到 HTTP 202 代表已送審，不是已公開。核准後正式企業專頁及公開 API 才會同步更新。為維持既有資料，建議客戶端送完整的文字語言欄位映射，而非只送單一語言。
dist/ 無法提供後台 API。BSGAI_ADMIN_TOKEN 應至少 32 字元、亂數產生，不能硬編碼到 HTML 或 JS。