天问·梅花易数:以时间/报数/测字起卦,输出本卦-互卦-变卦、体用五行生克、分项占断(事业/感情/财运/健康/应期)与 AI 大师千字深度解读
天问·梅花易数:以时间/报数/测字起卦,输出本卦-互卦-变卦、体用五行生克、分项占断(事业/感情/财运/健康/应期)与 AI 大师千字深度解读。单次 ¥1.99。
请求参数
POST /api/resource 请求体:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | 是 | 所问之事(一事一占,1-200 字),如「近期跳槽是否顺利」 |
method |
string | 否 | 起卦方式:time(默认,按当前时间) / number(报数) / char(测字) |
numbers |
int[] | 否 | method=number 时必填,1-999 的整数 |
text |
string | 否 | method=char 时必填,用于测字的文字 |
用户没说起卦方式时默认用 time。用户报了数字就用 number,给了字就用 char。
支付与交付
付费前置检查
调用本技能前,确认当前 Agent 已具备支付宝官方买家支付能力(alipay-payment-skill / alipay-bot)。
- 已具备:继续提供付费服务
- 未具备:提示用户「需先安装支付宝官方支付能力(npx -y @alipay/agent-payment@latest install)」并终止,不要自行实现付款或伪造凭证
工作流程(支付宝 A2M / HTTP 402 协议)
第一步:请求资源
向业务接口发起原始请求:
POST https://meihua.astrakairos.com/twmeihua/api/resource
Content-Type: application/json
<业务请求体,见下方「请求参数」>
第二步:处理 402 响应(支付触发)
未付款时服务返回 HTTP 402,并在响应头 Payment-Needed 携带 base64url 账单,响应体含 preview(免费真数据预览)与 out_trade_no。
- 先向用户展示 preview 内容(这是用户自己的真实测算结果片段),再说明「支付 ¥X 解锁完整报告」,引导付费——不要只甩一句"请支付"。
- 将 Payment-Needed 头的值和原始请求(URL、method、body)交给官方支付能力发起收银:
alipay-bot 402-buyer-pay \
--session-id <会话ID> \
--file <保存 Payment-Needed 的文件> \
--resource-url https://meihua.astrakairos.com/twmeihua/api/resource \
--method POST \
--intent-summary "<原始请求摘要>"
用户扫码/免密完成支付授权。你只负责编排,绝不接触支付私钥,也不自行实现签名。
第三步:支付成功后获取资源(必须执行)
付款后复用同一原始请求重试,通过请求头 Payment-Proof 携带官方返回的支付凭证:
POST https://meihua.astrakairos.com/twmeihua/api/resource
Content-Type: application/json
Payment-Proof: <官方 402-buyer-pay 返回的凭证>
<与第一步完全相同的业务请求体>
服务端验付通过后返回 HTTP 200,响应体 content 即完整付费结果,响应头 Payment-Validation 为验付回执。
- content 中若含 report_url,请把该链接完整展示给用户(精美报告页)。
- 同一订单重试幂等:已履约会返回 already_fulfilled: true 并给出缓存结果,不会重复扣费或重复交付。
第四步:处理特殊响应(异常处理)
| code / HTTP | 含义 | 处理方式 |
|---|---|---|
Payment-Needed (402) |
需要支付 / 凭证无效需重新发起 | 展示 preview 引导支付;若为凭证过期,重新走第一步 |
SUCCESS (200) |
成功 | 完整展示 content,附上 report_url |
NOT_PAID / 402 rebill |
尚未完成支付 | 提示用户完成支付后携原凭证重试,勿重复下单 |
VERIFY_FAILED (502) |
验付查询失败 | 稍后携原 Payment-Proof 重试,不要让用户重复付款 |
FULFILLMENT_CONFIRM_FAILED (502) |
结果已生成但履约回执失败 | 稍后携同一 Payment-Proof 重试(不会重复扣费) |
FULFILL_FAILED (500) |
业务生成失败 | 告知用户款项未履约可联系卖家退回,勿重复付款 |
状态不明时:先查询原订单状态,绝不重复付款或追加独立回执。
响应示例
402(未付款,含免费真预览):
{
"code": "Payment-Needed",
"message": "卦象已起,支付 ¥1.99 解锁专业解读…",
"out_trade_no": "TW1010144800abcd1234",
"amount": "1.99",
"preview": {
"hex_name": "山风蛊", "hex_brief": "元亨,利涉大川",
"ti": "巽", "ti_element": "木", "yong": "艮", "yong_element": "土",
"wuxing_level": "平",
"preview_text": "已起得「山风蛊」,体卦巽(木)、用卦艮(土),平象。",
"lines": [0,1,1,0,0,1]
},
"preview_note": "预览为本卦真数据(免费);支付后解锁完整专业解读报告"
}
200(已付款,完整交付):content 含 ben_hex/hu_hex/bian_hex、ti/yong/wuxing、prediction(overall/career/love/finance/health/advice/timing)、yearly、deep_advice、ai_reading、report_url。
展示要求
- 收到 402 先展示 preview 的真卦象(卦名+体用+吉凶级别),把付费定位为「解锁完整解读」而非「从零开始算」。
- 收到 200 后完整呈现分项占断与 AI 大师解读,并把
report_url作为「查看精美报告」链接给用户。
声明:本服务基于中国传统易学文化,结果仅供文化参考与娱乐,不构成任何医疗、投资、法律或重大决策建议。