天问·大六壬:大六壬起课:四课三传、天将、六亲、课体课名与断语
天问·大六壬:大六壬起课:四课三传、天将、六亲、课体课名与断语。单次 ¥1.99。
请求参数
POST /api/resource 请求体:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | 是 | 所问之事(1-200 字) |
支付与交付
付费前置检查
调用本技能前,确认当前 Agent 已具备支付宝官方买家支付能力(alipay-payment-skill / alipay-bot)。
- 已具备:继续提供付费服务
- 未具备:提示用户「需先安装支付宝官方支付能力(npx -y @alipay/agent-payment@latest install)」并终止,不要自行实现付款或伪造凭证
工作流程(支付宝 A2M / HTTP 402 协议)
第一步:请求资源
向业务接口发起原始请求:
POST https://meihua.astrakairos.com/twliuren/api/resource
Content-Type: application/json
<业务请求体,见上方「请求参数」>
第二步:处理 402 响应(支付触发)
未付款时服务返回 HTTP 402,并在响应头 Payment-Needed 携带 base64url 账单,响应体含 preview(免费真数据预览)与 out_trade_no。
- 先向用户展示 preview 内容(这是用户自己的真实排盘结果片段),再说明「支付 ¥1.99 解锁完整报告」,引导付费——不要只甩一句"请支付"。
- 将 Payment-Needed 头的值和原始请求(URL、method、body)交给官方支付能力发起收银:
alipay-bot 402-buyer-pay \
--session-id <会话ID> \
--file <保存 Payment-Needed 的文件> \
--resource-url https://meihua.astrakairos.com/twliuren/api/resource \
--method POST \
--intent-summary "<原始请求摘要>"
用户扫码/免密完成支付授权。你只负责编排,绝不接触支付私钥,也不自行实现签名。
第三步:支付成功后获取资源(必须执行)
付款后复用同一原始请求重试,通过请求头 Payment-Proof 携带官方返回的支付凭证:
POST https://meihua.astrakairos.com/twliuren/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 先展示 preview 的真排盘数据,把付费定位为「解锁完整解读」而非「从零开始算」。
- 收到 200 后完整呈现结构化排盘与解读,并把
report_url作为「查看精美报告」链接给用户。
声明:本服务基于中国传统数术文化整理,结果仅供文化参考与娱乐,不构成任何医疗、投资、法律或重大决策建议。