周易吉凶测试

接口标识: fortune 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

周易吉凶测试接口，基于80/81数理算法，支持手机号/QQ/身份证号/车牌号/随机数五种数字类型的吉凶测算。纯本地计算，毫秒级响应，无上游依赖。idcard类型日志自动脱敏（前6+****+后4）。

详细介绍

传入一串数字（手机号、QQ号、身份证号、车牌号或随机数），毫秒级返回传统 81 数理的吉凶等级、分数与解释文案。纯本地计算，不调用任何大模型，结果完全确定可复现。

## 接口概述

周易吉凶测试接口面向数字命理娱乐场景：传入 type（测试类型）与 content（待测字符串），接口从字符串中提取数字、取最后四位，按传统「八十一数理」算法计算——后四位除以 80 取小数部分再乘 80，得到 1~80 的数理序号，查表返回对应的吉凶等级（ji）、分数（output_score）与四言解释文案（output_content）。

整个计算在本地完成，不依赖大模型也不访问外部服务，响应为毫秒级；同一入参永远得到同一结果，可安全用于需要稳定复现的展示场景。数理表采用公有领域的传统八十一数理吉凶表（81 条）。每条结果固定附带免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。

按次计费，无上游成本。

## 核心能力

1. **五种数字类型**：phone（手机号）、qq（QQ号）、idcard（身份证号）、car（车牌号）、random（随机数）共用同一套数理算法，靠 type 区分场景。
2. **输入宽容**：算法只提取字符串中的数字部分，车牌号可直接传「京A12345」，身份证末位 X 自动忽略，不足四位前补 0。
3. **纯本地零延迟**：不调用大模型、不访问外部服务，毫秒级返回，适合高频调用与列表批量测算。
4. **结果确定可复现**：同一入参永远得到同一分数与文案，便于缓存、对账与自动化测试。
5. **身份证脱敏**：idcard 类型在调用日志中只存掩码（前 6 位 + **** + 后 4 位），原文不落库。
6. **合规内置**：数理原文中的恐吓性措辞在输出前统一替换为中性表达，且保持四言句式节奏不被破坏。

## 产品优势

- **量化分数 + 等级双口径**：output_score（1~100）便于排序与做进度条，ji（大吉/吉/半吉/凶）便于直接渲染成标签，两者同源不冲突。
- **文案可直接上屏**：output_content 是完整的四言吉凶判词，无需二次加工即可展示。
- **零上游成本**：纯本地计算，按次扣点，不因大模型价格波动产生成本漂移。

## 效果展示

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| type | qq | 测试类型，可选 phone/qq/idcard/car/random |
| content | 123456789 | 待测字符串，只取其中数字的后四位参与计算 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 吉凶分数 | 81 | `output_score`，1~100 整数 |
| 吉凶等级 | 吉 | `ji`，大吉/吉/半吉/凶 |
| 数理序号 | 68 | `index`，1~80 |
| 吉凶解释 | 顺风顺水，智虑周密。精通事务，必获成功。 | `output_content` |
| 免责声明 | 本结果仅供娱乐与传统文化参考，不构成任何专业建议。 | `notice` |

五种类型的真实算例（均为本地实算输出，可复现）：

| type | content | index | output_score | ji | output_content |
|------|---------|-------|--------------|----|----------------|
| phone | 13800138000 | 80 | 28 | 凶 | 遁世之数，孤独遭难。忧愁烦闷，难以安稳。 |
| qq | 123456789 | 68 | 81 | 吉 | 顺风顺水，智虑周密。精通事务，必获成功。 |
| idcard | 110101199003074567 | 6 | 91 | 大吉 | 六爻之数，发展变化。天赋吉运，安稳余庆。 |
| car | 京A12345 | 25 | 79 | 吉 | 荣俊之数，资性英敏。才能奇特，克服万难。 |
| random | 8888 | 7 | 80 | 吉 | 七政之数，精悍严谨。独立权威，刚毅果断。 |

合规过滤示例：手机号 19912345678 命中数理 77，原文为「半吉之数，先苦后甜。须防外患，晚年吉祥。」，接口返回时「外患」已替换为中性的「外忧」，四言句式节奏不变。

## 应用场景

- **数字命理站点**：手机号测吉凶、车牌号测运势等页面的核心接口，单次调用即可上屏
- **营销活动**：把用户手机号或订单号的吉凶分数做成趣味互动，提升参与与分享
- **小程序/App**：工具类页面的「测一测」入口，毫秒级响应不影响页面加载体验

## 应用案例

- **某工具类小程序**：手机号吉凶测试页接入本接口，用 output_score 渲染吉凶进度环、ji 渲染等级标签、output_content 作为判词展示，整页内容由一次调用完成。
- **某营销活动页**：用户输入订单号后调用本接口，把分数映射为趣味运势卡片，配合分享文案提升传播率；因结果确定可复现，同一订单号每次刷出的卡片一致。

## 注意事项

- 结果为传统文化娱乐化解读，不构成任何专业建议，也不应作为任何决策依据。
- name（姓名）类型依赖康熙笔画与汉字五行数据底座，首期暂未开放，传入返回参数错误。
- 参与计算的只有提取出的数字后四位，前面的数字不影响结果（已实测验证）：
  13800138000 与 00013800138000 后四位同为 8000，两者结果完全相同（数理 80、28 分）；
  而 13800138001 后四位是 8001，结果就完全不同（数理 1、95 分）。
- 数字不足四位时前补 0：传 88 与传 0088 结果相同（同为数理 8、78 分）。
- content 中提取不到任何数字时返回参数错误。
- 身份证号属敏感信息，接口只用于计算不落库原文，调用日志中按掩码存储。

周易吉凶数理测试 fortune

接口地址： https://www.phpwc.cn/api/fortune

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`type`	string	必填	-	测试类型：phone(手机号) / qq(QQ号) / idcard(身份证号) / car(车牌号) / random(随机数)。name(姓名) 依赖康熙笔画数据底座，暂未开放，传入返回参数错误
`content`	string	选填	-	待测字符串。算法只提取其中的数字部分：车牌号可含汉字与字母（如京A12345），身份证末位 X 自动忽略，不足四位前补 0，实际参与计算的是最后四位。type=random 时可留空，接口自动生成 4 位随机数。★ idcard 类型在日志中脱敏存储（前 6 位 + **** + 后 4 位），原文不落库

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`output_score`	int	吉凶分数 1~100（实测 81 数理表覆盖区间为 22~98），分数越高越吉
`output_content`	string	吉凶解释文案，取自传统 81 数理原文并已过合规过滤（恐吓性措辞替换为中性表达，四言句式保持不变）
`type`	string	回显本次测试类型
`index`	int	命中的数理序号 1~80
`ji`	string	吉凶等级：大吉 / 吉 / 半吉 / 凶
`notice`	string	免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试