该接口是支付回调验签服务中唯一能穿透WAF校验X-Hmac-Signature的通道，若调用失败将导致整批微信回调被拦截，商户侧资金入账延迟超30分钟；字段biz_order_id定义在OrderCallbackRequest第21行，类型String，由上游HTTP Header注入；nonce_str为32位小写十六进制字符串，长度或大小写错误时网关直返400；X-Hmac-Signature需base64解码后转bytes，于callback.py第87行参与hmac.compare_digest校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让codeium生成的接口对接说明能被一线开发直接粘贴进飞书文档、被测试同学拿来写用例、被运维同事用来配网关策略，而不是产出一堆“请求方式为post”“参数需按json格式提交”的废话——这种内容连新来的实习生都写得出来。用业务卡点锚定接口价值
在提示词最开头写明该接口在真实链路中的不可替代位置，且必须包含失败后果。例如：“该接口是支付回调验签服务中唯一能穿透WAF校验X-Hmac-Signature的通道，若调用失败将导致整批微信回调被拦截，商户侧资金入账延迟超30分钟。”
这一步不能省略。没有后果描述，Codeium会默认进入“功能说明书”模式，自动补全“用于校验签名合法性”这类被动句式。
【必须出现具体下游依赖方和超时阈值】
把字段说明绑定到代码现场
方法一：强制字段名与源码完全一致
在提示词中直接写出字段原始命名、所在类及行号。例如：“请说明字段【biz_order_id】(非‘业务订单号’)的生成逻辑，该字段定义在Java类 OrderCallbackRequest 第21行，类型为String，由上游通过HTTP Header注入，不参与本地生成。”
方法二：用类型+长度+校验规则三重锁定
写清楚：“【nonce_str】为32位小写十六进制字符串，由调用方生成并透传，本接口仅做长度校验；若含大写字母或长度≠32，中间件将在网关层直接返回400，不进入业务逻辑。”
注意：不要写“nonce_str是随机字符串”，Codeium会套用OAuth2规范解释，而你实际用的是自研防重放机制。
嵌入可执行的调用片段作为结构锚点
第一步：在提示词末尾粘贴一段真实调用代码（截取关键3～5行），要求说明必须围绕这段代码展开：
resp = requests.post(<br> url="https://api.pay.example.com/v3/callback/verify",<br> headers={"X-Hmac-Signature": sig, "nonce_str": "a1b2c3d4e5f678901234567890abcdef"},<br> json={"order_id": "PAY_20260703_112045", "amount": 19990}<br>)
第二步：明确指令：“headers部分必须解释【X-Hmac-Signature】的计算公式（含密钥来源、拼接顺序、HMAC-SHA256调用方式），json部分必须说明【amount】单位是‘分’且必须为正整数，若为0或负数将触发风控拦截。”
第三步：加一句硬约束：“所有说明文字必须能让值班SRE在告警发生时，3秒内判断出是否应联系支付组——禁止出现‘用于……’‘提供……能力’等被动句式。”
用错误日志倒逼实操细节
粘贴一段真实报错堆栈（不加引号、不加说明）：
Traceback (most recent call last):
File "/src/handler/callback.py", line 87, in verify_signature
hmac.compare_digest(expected_sig, actual_sig)
TypeError: expected bytes, got str
紧跟一句：“请围绕此报错说明【X-Hmac-Signature】字段在Python服务端的解码方式（是否base64解码？是否需转bytes？在哪一行完成转换？），不提‘建议检查类型转换’这类空话。”
【报错必须带真实文件路径和行号，否则Codeium会泛化成‘字符串与字节比较错误’】
