Fortune TempleWealth Shrine

API 文档

Fortune Temple

API 文档

Fortune Temple 为开发者提供 RESTful API，可将命理分析功能集成到您的应用中。以下是完整的接口文档。API Key 可在登录后「个人中心」→「开发者设置」中获取。

认证方式

所有 API 请求需要在 HTTP Header 中携带 API Key。Secret Key（ft_sk_）用于服务端调用，Publishable Key（ft_pk_）可用于前端。

GET /v1/bazi/paipan HTTP/1.1
Host: api.fortunetemple.com
Authorization: Bearer ft_sk_xxxxxxxxxxxxxxxx

基础信息

Base URL

https://api.fortunetemple.com/v1

请求格式

Content-Type: application/json; charset=utf-8
限流限流规则 (Rate Limits)

免费用户 — 100 次/天，峰值 10 次/分钟
Gold 会员 — 1,000 次/天，峰值 30 次/分钟
FortuneVIP — 10,000 次/天，峰值 100 次/分钟
企业定制 — 联系 [email protected]

接口列表

POSTPOST /v1/bazi/paipan — 八字排盘

根据出生信息排出八字四柱、大运和流年。

请求参数： name(姓名), gender(male/female), birth_date(YYYY-MM-DD), birth_time(HH:MM), calendar(solar/lunar), timezone(Asia/Bangkok等), lang(zh-CN/en等)
返回： pillars(四柱天干地支生肖), day_master(日主五行), wuxing_balance(五行分布), yong_shen(用神), da_yun(大运), score(综合评分0-100)

POSTPOST /v1/divination/slip — 灵签占卜

从签文库中随机抽取一支签并返回解读。

请求参数： question(问题), slip_library(guanyin/guandi/wongtaisin), lang
返回： slip_number(签号), level(签等), title(签题), poem(签诗), interpretation(白话解读), career_advice, love_advice

POSTPOST /v1/name/analyze — 姓名学分析

用五格剖象法分析姓名的吉凶和五行配置。

请求参数： surname(姓), given_name(名), lang
返回： stroke_counts(笔画数), five_grids(五格数值/五行/吉凶), overall_score(综合分), sancai(三才配置), sancai_comment

POSTPOST /v1/charm/generate — 招财符生成

生成一张专属招财符图片（PNG/WebP格式）。

请求参数： name, wish(愿望), style(traditional/modern), format(png/webp), width, height
返回： charm_id, image_url(CDN地址，30天有效), expires_at

POSTPOST /v1/phone/analyze — 手机号分析

分析手机号码的数理吉凶和八星磁场。

请求参数： phone_number, lang
返回： total_strokes, shuli_score(数理评分), cichang(八星磁场分析: segments分段, stars吉凶星, overall_comment综合评语)

错误码说明

  • 401 — API Key 无效或已过期
  • 403 — 权限不足（免费用户调用高级接口）
  • 429 — 超出速率限制，请稍后重试
  • 400 — 请求参数不合法（详见 message 字段）
  • 500 — 服务器内部错误，我们会自动收到告警
← 首页