接第三方 API / 服务

我要在项目里接入 {{服务名，如 微信支付 / 高德地图 / OpenAI}}。

我的技术栈：{{如 Next.js + TypeScript}}
要实现的场景：{{具体要做什么，如 用户下单后发起支付}}

请帮我：
1. 说明接入的整体流程（有哪些角色、数据怎么流转）。
2. 列出需要的凭证/密钥，以及它们应该放在哪（哪些绝对不能放前端）。
3. 给出最小可跑通的调用代码示例，包含错误处理和超时。
4. 列出这个服务常见的坑：{{如 签名、回调、配额、沙箱环境}}。
5. 告诉我在本地怎么测（有没有沙箱/测试模式）。

要求：
- 涉及密钥的地方，明确标注必须走服务端。
- 不要跳过回调/异步通知的处理，这是最容易漏又最致命的部分。
- 如果官方文档有必须注意的限制（频率、资质、备案），提醒我。

把 {{}} 里的部分换成你自己的内容

为什么这么写

1. 先要整体流程图，避免只拿到一段调用代码、却不知道回调和状态怎么处理
2. 明确密钥存放位置，直接堵住「把 secret 写进前端」这个最常见也最致命的错误
3. 强制包含错误处理和超时，因为第三方接口失败是常态不是异常
4. 要求提醒资质/备案限制，这类非技术问题往往才是真正卡住上线的（比如小程序备案要大陆身份证）

用起来的样子

接微信支付时，AI 会画出「下单→调起支付→异步回调→查单确认」的链路，并强调回调必须验签、不能只信前端返回。

常见坑

• !只 copy 一段调用示例就上线，漏了回调和异常，用户付了钱订单没更新
• !把密钥放前端，等于把账号密码公开

相关分类