API接入说明须精准定义输入输出结构、真实调用示例及调试工具链要求：输入含app_id、timestamp、signature三字段并明确类型与约束；输出分成功与两类失败响应；附可运行curl示例；指定Postman 10.22+适配细节；禁用模糊修饰词，枚举所有合法参数组合及错误码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
写API接入说明的提示词时，空话套话会让开发者反复猜意图、查文档、试错重写，直接拖慢联调进度。必须让提示词精准锁定输入格式、字段含义、错误响应边界和真实调用链路。
明确限定输入输出结构
第一步：在提示词开头就用三行固定格式声明「输入→处理→输出」关系，例如：
输入：JSON对象，含app_id（字符串，长度32位）、timestamp（整数，秒级Unix时间戳）、signature（HMAC-SHA256签名，小写十六进制）；
处理：校验签名有效性，检查timestamp是否在当前时间±300秒内；
输出：成功返回{"code":0,"data":{"token":"xxx"}}，失败返回{"code":401,"msg":"invalid signature"}或{"code":408,"msg":"timestamp expired"}。
这一步不能只写“请返回标准JSON”，必须把每个字段名、类型、约束条件、取值范围全列出来。漏掉timestamp的±300秒容忍窗口，联调时就会因时钟偏差报408却找不到原因。
强制绑定真实调用上下文
方法一：嵌入最小可运行示例
在提示词里直接给出curl命令和对应请求体，要求说明文档必须能让人复制粘贴后跑通：
curl -X POST https://api.example.com/v1/auth \<br> -H "Content-Type: application/json" \<br> -d '{"app_id":"a1b2c3d4","timestamp":1717023456,"signature":"e8f9a7b1c2d3e4f5a6b7c8d9e0f1a2b3"}'
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
方法二：指定调试工具链
写明“说明需适配Postman 10.22+ 的Collection v2.1格式，环境变量命名为BASE_URL、APP_ID、SECRET_KEY，且预请求脚本中必须包含pm.variables.set("signature", CryptoJS.HmacSHA256(payload, pm.variables.get("SECRET_KEY")).toString(CryptoJS.enc.Hex).toLowerCase());”——这样写的提示词生成的文档，开发人员打开Postman就能直接导入运行。
剔除模糊修饰词与责任转嫁表述
删掉所有“高效”“灵活”“强大”“业界领先”类形容词。这些词不提供任何可执行信息。
禁止出现“开发者可根据实际情况调整参数”——【实际参数组合只有3种合法路径，必须穷举】。比如：当mode=sync时timeout必填且≤10；当mode=async时callback_url为必填且需HTTPS；当mode=webhook时retry_times允许缺省，默认3次。
把“建议参考官方文档”改成“此处字段region仅接受以下4个枚举值：cn-hangzhou、us-west-1、ap-southeast-1、eu-central-1，传其他值将返回HTTP 400及{"code":4001,"msg":"invalid region"}”。
