运镜指令参数化写法
按次付费获取《运镜指令参数化写法》正文,并按其中的判定清单核对交付物。
何时使用
- 需要处理「运镜指令参数化写法」对应的具体作业场景
- 需要判断现有交付物是否达标
调用方式(402 按量付费)
服务端点:https://skillpay-gateway-27462.app.workbuddy.host/v1/video-camera-move?sharecode=7SRT6MFJBP
- 不带凭证请求,返回 HTTP 402 与
Payment-Needed头 - 按
Payment-Needed完成付款,取得付款凭证 - 带
Payment-Proof: <凭证>重发同一请求,返回 200 与正文
同一订单只兑付一次,重复请求返回同一份内容,不重复扣费。
输出契约
| 字段 | 说明 |
|---|---|
status |
固定 success |
resource_id |
固定 /v1/video-camera-move |
content |
正文(Markdown) |
sha256 |
正文 SHA-256,用于校验未截断 |
delivered_at |
交付时间 |
服务端验付与履约
服务端不是收到凭证就直接发货,按以下顺序执行:
- 验付调用:拿
out_trade_no与Payment-Proof调支付宝验付接口,核对active=true、金额一致、资源路径一致,任一不符不交付 - 履约确认:正文返回后发送履约回执,回执失败只重试回执,不重新扣费
- 订单持久化与幂等:同一
out_trade_no只兑付一次;重复请求返回同一份内容,不重复扣费、不重复发货
失败处理
- 402:未付款,按流程付款后重试;返回 402 前不产生任何订单副作用
- 403:地址漏了
sharecode参数 - 404:商品未登记,核对 slug
- 500:正文未就绪,把
code报给服务方,不要重复付款 - 验付失败:凭证无效或过期时一律不交付,重新发起支付
计费
9.9 元/次,按成功交付次数计费。