api接入说明须包含前置条件、请求示例、响应解析、排障清单四部分；须按指定顺序呈现，每段代码后须含“须”“应”各一次的说明，signature须用hmac-sha256+平台secret_key生成，不可硬编码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Gemini生成一份能直接贴进内部技术文档的API接入说明，但每次输出都漏掉鉴权方式、错误重试逻辑或请求频率限制——不是它不会写，而是你没用对提问句式。
问清调用链路起点与终点
第一步：明确告诉Gemini本次接入的上下游角色。例如：“本API由【前端Web页面】发起调用，经【Nginx网关】转发至【Java微服务集群】，最终响应返回给浏览器。”
第二步：指定入口和出口的物理形态。“入口必须支持GET/POST两种方法，且POST请求体为application/json；出口响应体须含code、message、data三字段，data结构为扁平化JSON对象，不可嵌套超过2层。”
第三步：锁定最关键的失败拦截点。“若请求未携带X-Auth-Token头，网关应直接拒绝并返回401，不透传至后端服务。”
逼它暴露隐性依赖项
方法一：用“缺失时现象”倒逼检查清单
“请列出本API所有隐性依赖项，并为每一项说明：若该依赖缺失，客户端会收到什么HTTP状态码、error.status值、响应体中哪一字段为空或异常。”
方法二：强制绑定环境变量名
“所有需配置的参数必须显式标注环境变量名，例如：API密钥对应process.env.GEMINI_API_KEY，超时时间对应process.env.API_TIMEOUT_MS，不可写作‘请配置密钥’这类模糊描述。”【process.env.GEMINI_API_KEY必须大写且带下划线，小写或驼峰命名会导致Node.js运行时报错】
限定输出格式与校验锚点
“生成的接入说明必须包含以下四个区块，顺序不可调换：①前置条件（开通服务+实名认证+配额申请）；②请求示例（含curl命令与JavaScript fetch片段）；③响应解析（code=0表示成功，code=4001表示手机号格式错误）；④排障清单（按‘现象→日志关键词→定位命令’三列表格呈现）。”
“每段代码块下方必须紧跟一行说明文字，且该行必须含‘须’字一次、‘应’字一次，例如：‘调用前须校验mobile是否符合E.164格式，响应中应检查code字段是否为0。’”
注:signature字段须通过HMAC-SHA256算法生成，密钥为平台分配的secret_key，不可使用硬编码字符串。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
