缘份居国学研究开发者API
文档说明
- 品牌愿景：缘份居上线于2020年，是一家专注于数据服务的公司，我们的宗旨是致力于通过先进的技术手段，让古老而珍贵的国学文化更加容易被人们理解、学习和传承。我们的愿景是传承和发扬优秀的国学文化，为国内外企业提供国学研究解决方案。在全球范围内推广中华传统文化的价值与魅力。
- 文档归属：本文档接口提供者为缘份居，我们致力于给我们的用户提供一套专业且标准的 API 集成规则。对于该文档，我们拥有最终解释权，并保留随时修改的权利。使用该文档，您可以做到："八字排盘"，"西方占星"，"塔罗解读"，"摇卦占卜"，"周公解梦"，"择吉时"，"紫微排盘"，"奇门排盘" 等近百种功能，完整功能详见 接口列表
特别声明：本文档接口提供国学文化研究，所有算法均为娱乐研究使用，不得作为生活、工作之指导，严禁使用数据进行封建迷信违法用途。使用本接口必须遵守国家有关法律和政策等，维护国家利益，保护国家安全，对于用户违法或违反使用而引起的一切责任，由用户负全部责任，一概与本平台及合作单位无关，导致本平台及合作单位损失的，本平台有权要求用户赔偿。
平台优势
全链路数据输出，降低开发成本
提供“排盘结果+结构化数据+解读文案”的一体化输出能力（部分支持SVG可视化图表）。开发者无需自行拼接底层逻辑或设计前端展示，大幅减少前期开发与联调的繁琐工作量。
结构化输出，适合产品化开发
所有核心数据均以标准结构化 JSON 格式返回，采用高度统一的字段规范设计。完美兼容前端多端设备适配（APP/小程序/Web）与业务横向扩展，专为长期产品化运营打造。
多术数体系覆盖，业务扩展性强
底层集成八字、紫微、占星、塔罗、奇门、周易等近百种传统文化与内容处理模型。一套 API 体系即可支持多种复杂业务场景的平滑扩展，显著降低多供应商切换的资金与维护成本。
接口架构稳定，适合持续性运营
核心接口采用高可用架构设计，严守底层数据结构的长期稳定维护与向下兼容原则。有效避免因接口频繁变更而带来的额外适配与修复成本，让拥有持续运营及高并发需求的产品安枕无忧。
规范化对接设计，沟通成本低
遵循业界标准规范的接口语义设计，配套提供详尽入微的调用文档、字段说明及示例代码。开发者可无障碍快速阅读并独立完成测试联调，极大降低跨团队的技术沟通成本与前期开发门槛。
极简化轻量接入，助力快速上线
提供极简的鉴权机制与轻量的调用方式，全面剔除冗杂的对接流程。配合专业的售后技术支持，技术团队通常在 1–3 个工作日内即可完成核心基础功能的无缝接入并顺利发布上线运行。
应用场景
文化内容类小程序 / APP（用户内容服务）
增值内容类产品（运势解读 / 测算报告）
情感匹配 / 合婚分析 / 人际关系解读
星座占星 / 星盘分析 / 个性解读产品
趣味测试 / 互动内容（用户增长与引流）
国学文化平台 / 海外文化内容产品
已广泛应用于多类产品场景，支持从用户增长到内容变现的完整业务闭环。
注：部分客户涉及商业合作，不便公开具体名称。
准备工作
-
获取密钥：请仔细通读本文档，并获取重要的参数：
api_key。该参数可以通过缘份居商户后台获取，名字叫密钥，是一行蓝色的字符串，用户可以点击右上角 注册账号 自行注册。 -
请求方式：如无特别说明，所有请求参数皆为必选，建议发起
POST请求，请求参数是表单形式的编码 form-data。另外我们也支持使用GET发起请求，但是 GET 请求有密钥泄露风险，非必要建议POST。 - 免费测试：关于测试部分，我们对于新注册的用户给予足够的测试次数，注册即赠送 150 次。出于系统安全与资源保护考虑，同一网络环境在一定时间内仅支持有限次数的账号注册。
-
多语言与源码支持：左侧接口列表中，如果带有特殊符号 的说明该接口支持
多语言，但是对于en-us而言，只有解析部分进行了翻译，基础部分依然为中文。为了方便技术对接，我们提供了模板源码，方便二次开发。请点击 这里 联系我们的客服获取下载链接。