Public API v1
開發者文件
這是一個小型唯讀介面，只提供 GFSA 網頁已展示、經人工批准的公開快照。用途是研究探索與透明的公共目錄重用，不用於帳戶自動化、證書決策、個人化建議、白標服務或租戶管理。
GET / HEAD僅批准公開快照無寫入 API無瀏覽器跨域 CORS
契約摘要
- 基礎網址：
https://globalfengshui.org/api/v1 - 方法：
GET及HEAD. 其他方法回傳 405。 - 格式： UTF-8 JSON;
api_version標示本契約版本。 - 分頁：
limit1–50, 預設 20；把回傳的next_cursor作為after. - 快取： 成功的公開回應最多可快取 300 秒。
- 基礎流量控制： 100 次網站請求／每用戶端 60 秒（現行 WAF 基線）；必要時可採更嚴限制。
資源端點
| 端點 | 內容 | 公開邊界 |
|---|---|---|
/api/v1/members | 公開會員／檔案名稱、批准的簡介、已啟用的位置／分類代碼及公開身分徽章狀態。 | 有效公開檔案及批准版本；再次套用每個顯示開關。 |
/api/v1/organizations | 公開機構代碼、名稱、國家、概述、服務範圍與界線。 | 有效機構及已批准公開快照。 |
/api/v1/knowledge | 經審核的術語、定義、注意事項及來源覆蓋狀態。 | 有效、已批准且不可變的條目版本。 |
/api/v1/cases | 概括區間及截短的去標識案例摘要、方法、觀察與限制。 | 僅去標識並經人工批准的快照。 |
/api/v1/industry-data | 已發布的年度聚合快照及公開指標。 | 已發布週期／快照；指標必須通過固定隱私閾值。 |
使用範例
讀取能力清單
curl --fail --silent \
"https://globalfengshui.org/api/v1"讀取第一頁
curl --fail --silent \
"https://globalfengshui.org/api/v1/knowledge?limit=20"使用回傳游標繼續
curl --fail --silent \
"https://globalfengshui.org/api/v1/knowledge?limit=20&after=123"刻意排除的資料
API 不公開電郵、電話、網站或社交聯絡資料；帳戶識別碼或憑證；精確出生或位置資料；付款資料；服務交付或報告正文；貢獻者與團隊身分；同意參考編號；投訴或案例證據；個別調查回覆；內部審核備註、風險標記、抑制原因或管理員身分。
證書記錄不提供批量 API。請使用受治理的單筆查驗頁面，並在語境中判讀範圍、狀態與到期日。
瀏覽器存取、署名與可靠性
- 不傳送 Access-Control-Allow-Origin 標頭。跨來源瀏覽器 JavaScript 不受支援；請使用同源或伺服器端整合。
- 再發布時須署名全球風水協會（GFSA）、保留來源檔案網址與快照日期，且不得暗示認可或即時狀態。
- 這是無正常運行時間 SLA 的盡力型公共服務。應處理 400、404、405、429 與 5xx 回應；暫時故障只可採有界限的指數退避重試。
白標與多租戶邊界
GFSA 的機構角色只是應用程式權限，並非加密或資料庫租戶邊界。因此，目前由 Access 支援的應用程式不會被描述為白標或多租戶 SaaS 平台。未來若提供相關服務，必須先具備強制租戶鍵與列隔離的服務型資料庫、每租戶密鑰與稽核／限流控制、獨立備份還原及資料駐留流程、合約隱私控制、安全測試，以及受治理的自訂網域／品牌運作。
條款與查詢
使用受網站條款、隱私通知與知識產權聲明約束。公開可用不代表放棄第三方權利，也不允許誤導、歧視，或作出自動化資格、信貸、就業、保險、健康、法律及其他高影響決策。