缘份居国学研究开发者API
文档说明
- 品牌愿景：缘份居上线于2020年，专注于传统文化领域的数据整理、数字化处理及 API 技术服务，致力于通过现代信息技术对相关传统文化资料与计算规则进行结构化处理，为国内外开发者、企业及相关软件应用提供标准化的数据接口与技术支持。
- 文档归属：本文档由缘份居提供，旨在为开发者提供专业、统一、标准化的 API 接入规范。目前平台已提供近百个 API 接口，涵盖传统文化数据处理、历法计算、排盘数据计算、西方星历计算及相关结构化数据服务，可用于网站、软件、AI 应用及其他信息系统的数据集成与技术开发。完整接口及功能说明详见 接口列表。
平台优势
提供“排盘结果+结构化数据+解读文案”的一体化输出能力（部分支持SVG可视化图表）。开发者无需自行拼接底层逻辑或设计前端展示，大幅减少前期开发与联调的繁琐工作量。
所有核心数据均以标准结构化 JSON 格式返回，采用高度统一的字段规范设计。完美兼容前端多端设备适配（APP/小程序/Web/AI应用）与业务横向扩展，专为长期产品化运营打造。
底层集成八字、紫微、占星、塔罗、奇门、周易等近百种传统文化与内容处理模型。一套 API 体系即可支持多种复杂业务场景的平滑扩展，显著降低多供应商切换的资金与维护成本。
核心接口采用高可用架构设计，严守底层数据结构的长期稳定维护与向下兼容原则。有效避免因接口频繁变更而带来的额外适配与修复成本，让拥有持续运营及高并发需求的产品安枕无忧。
专为 WordPress 站长打造了一体化免开发插件。安装后只需配置 API 密钥，即可一键在您的网站上线八字、紫微、奇门、六爻、梅花等全部完整功能，零代码实现流量变现。
提供极简的鉴权机制与轻量的调用方式，全面剔除冗杂的对接流程。配合专业的售后技术支持，技术团队通常在 1–3 个工作日内即可完成核心基础功能的无缝接入并顺利发布上线运行。
应用场景
文化内容类小程序 / APP（用户内容服务）
增值内容类产品（运势解读 / 测算报告）
情感匹配 / 合婚分析 / 人际关系解读
星座占星 / 星盘分析 / 个性解读产品
趣味测试 / 互动内容（用户增长与引流）
国学文化平台 / 海外文化内容产品
AI驱动应用 / 智能体产品（自动化内容与服务生成）
企业服务集成 / SaaS系统（API能力嵌入与业务扩展）
相关能力已在实际业务场景中验证，支持从内容生成、用户互动到商业变现的完整闭环， 可灵活适配传统应用与新一代智能体应用场景。
准备工作
-
获取密钥：请仔细通读本文档，并获取重要的参数：
api_key。该参数可以通过缘份居商户后台获取，名字叫【开发密钥】，用户可以点击右上角 注册账号 自行注册。 -
请求方式：如无特别说明，所有请求参数皆为必选，建议发起
POST请求，请求参数是表单形式的编码 form-data。另外我们也支持使用GET发起请求，但是 GET 请求有密钥泄露风险，非必要建议POST。 - 免费测试：关于测试部分，我们对于新注册的用户给予足够的测试次数，注册即赠送 150 次。出于系统安全与资源保护考虑，同一网络环境在一定时间内仅支持有限次数的账号注册。
- 计费说明： 接口采用灵活套餐计费模式，支持按量与包年方案。 开发者可根据业务规模自由选择，详情请参考 费用说明 。
-
多语言与源码支持：左侧列表中带有 标识的接口均支持多语言切换，普遍覆盖
简体中文 (zh-cn)与繁体中文 (zh-tw)，部分接口额外支持英文 (en-us)。为了方便技术对接，我们提供了模板源码方便二次开发，请点击 联系客服 获取下载。 - WP 专属插件：针对 WordPress 站长，我们提供了一款高度集成的官方插件。安装后配置密钥即可开启全套国学功能。无需复杂对接，您可以点击 此处查看和下载，然后在网站后台上传即可使用。
- 支付方式：支持微信支付、支付宝、对公转账及国际电汇。境外企业客户如需通过银行进行跨境付款，可联系客服获取国际电汇收款信息。