緣份居國學研究開發者API

文件說明

  • 品牌願景：緣份居上線於2020年，是一家專注於資料服務的公司，我們的宗旨是致力於通過先進的技術手段，讓古老而珍貴的國學文化更加容易被人們理解、學習和傳承。我們的願景是傳承和發揚優秀的國學文化，為國內外企業提供國學研究解決方案。在全球範圍內推廣中華傳統文化的價值與魅力。
  • 文件歸屬：本文件API提供者為緣份居，我們致力於給我們的使用者提供一套專業且標準的 API 集成規則。對於該文件，我們擁有最終解釋權，並保留隨時修改的權利。使用該文件，您可以做到："八字測算"，"八字排盤"，"西方占星"，"塔羅解讀"，"搖卦占卜"，"周公解夢"，"擇吉時"，"紫微排盤"，"奇門排盤" 等近百種功能，完整功能詳見 API列表。
特別聲明：本文件API提供國學文化研究，所有演算法均為娛樂研究使用，不得作為生活、工作之指導，嚴禁使用資料進行封建迷信違法用途。使用本API必須遵守國家有關法律和政策等，維護國家利益，保護國家安全，對於使用者違法或違反使用而引起的一切責任，由使用者負全部責任，一概與本平臺及合作單位無關，導致本平臺及合作單位損失的，本平臺有權要求使用者賠償。

平臺優勢

全鏈路資料輸出，降低開發成本

提供「排盤結果+結構化資料+解讀文案」的一體化輸出能力（部分支援SVG可視化圖表）。開發者無需自行拼接底層邏輯或設計前端展示，大幅減少前期開發與聯調的繁瑣工作量。

結構化輸出，適合產品化開發

所有核心資料均以標準結構化 JSON 格式返回，採用高度統一的欄位規範設計。完美兼容前端多端設備適配（APP/App / 應用程式/Web）與業務橫向擴展，專為長期產品化運營打造。

多術數體系覆蓋，業務擴展性強

底層集成八字、紫微、占星、塔羅、奇門、周易等近百種傳統文化與內容處理模型。一套 API 體系即可支援多種複雜業務場景的平滑擴展，顯著降低多供應商切換的資金與維護成本。

API架構穩定，適合持續性運營

核心API採用高可用架構設計，嚴守底層資料結構的長期穩定維護與向下兼容原則。有效避免因API頻繁變更而帶來的額外適配與修復成本，讓擁有持續運營及高並發需求的產品安枕無憂。

豐富的生態支援，提供官方插件

專為 WordPress 站長打造了一體化免開發插件。安裝後只需設定 API 存取金鑰 (API Key)，即可一鍵在您的網站上線八字、紫微、奇門、六爻、梅花等全部完整功能，零程式碼實現流量變現。

極簡化輕量接入，助力快速上線

提供極簡的鑑權機制與輕量的呼叫方式，全面剔除冗雜的對接流程。配合專業的售後技術支援，技術團隊通常在 1–3 個工作日內即可完成核心基礎功能的無縫接入並順利發布上線運行。

應用場景

文化內容類App / 應用程式（使用者內容服務）

增值內容類產品（運勢解讀 / 測算報告）

情感匹配 / 合婚分析 / 人際關係解讀

星座占星 / 星盤分析 / 個性解讀產品

趣味測試 / 互動內容（使用者增長與引流）

國學文化平臺 / 海外文化內容產品

AI驅動應用 / 智能體產品（自動化內容與服務生成）

企業服務集成 / SaaS系統（API能力嵌入與業務擴展）

相關能力已在實際業務場景中驗證，支援從內容生成、使用者互動到商業變現的完整閉環， 可靈活適配傳統應用與新一代智能體應用場景。

註：目前已有境內外客戶使用我們的 API 服務，服務範圍涵蓋中國大陸、港澳台及東南亞等地區。因商業保密約定，具體合作方資訊不予公開。

準備工作

  • 獲取存取金鑰 (API Key)：請仔細通讀本文件，並獲取重要的參數：api_key。該參數可以通過緣份居商戶後臺獲取，名字叫【開發金鑰】，使用者可以點擊右上角 註冊帳號 自行註冊。
  • 請求方式：如無特別說明，所有請求參數皆為必選，建議發起 POST 請求，請求參數是表單形式的編碼 form-data。另外我們也支援使用 GET 發起請求，但是 GET 請求有存取金鑰 (API Key)洩漏風險，非必要建議 POST。
  • 免費測試：關於測試部分，我們對於新註冊的使用者給予足夠的測試次數，註冊即贈送 150 次。出於系統安全與資源保護考慮，同一網路環境在一定時間內僅支援有限次數的帳號註冊。
  • 計費說明： API採用靈活套餐計費模式，支援按量與包年方案。 開發者可根據業務規模自由選擇，詳情請參考 費用說明 。
  • 多語言與原始碼支援：左側列表中標有 圖示之 API 均支援多語言切換，普遍涵蓋 正體中文 (zh-tw) 與 簡體中文 (zh-cn)，部分 API 額外提供 英文 (en-us) 支援。為便於快速串接與二次開發，我們備有範例原始碼，歡迎點擊 聯絡客服 取得下載連結。
  • WP 專屬插件：針對 WordPress 站長，我們提供了一款高度集成的官方插件。安裝後設定存取金鑰 (API Key)即可開啟全套國學功能。無需複雜對接，您可以點擊 此處查看和下載，然後在網站後臺上傳即可使用。
  • 支付方式：支援微信支付、支付寶、對公轉帳及國際電匯。境外企業客戶如需通過銀行進行跨境付款，可聯絡客服獲取國際電匯收款資訊。
導覽目錄