本文是「小i约球诞生记」系列文章之一。小i约球是一个微信小程序主要帮乒乓球、羽毛球、台球、网球爱好者找到附近合适的球友。本文从一个具体技术或产品问题切入记录约球小程序从 0 到 1 过程中的设计取舍。前言这篇聊一个很烦的坑AI 会一本正经地编接口。不是写错参数也不是少了一个字段而是直接编出一个看起来像真的、实际并不存在的 API。更麻烦的是它还会顺手把调用代码、鉴权方式、错误处理都写出来。如果你没及时查官方文档很容易被带着跑。我在做小i约球时就遇到过一次。场景不复杂约球小程序需要做用户触达和社群联动比如附近有人发布乒乓球约球、羽毛球约球信息时后面可能要配合公众号、企业微信或群运营做一些提醒。我问 AI 有没有对应接口。它给得很快解释也很顺甚至把请求地址和示例脚本都补齐了。结果试了半天不通。最后回头查官方文档发现问题不是我写错了而是它说的那个接口压根不存在。AI 为什么会编得这么像这类错误最坑的地方是它不荒谬。如果 AI 编一个完全离谱的接口你一眼就能发现。但微信生态、企业微信、公众号、小程序这些能力本来就有很多相似的 API发消息、建群、拉人、查用户、同步成员、获取二维码。AI 很容易把几个真实能力拼在一起生成一个“看起来合理”的接口。比如路径像官方风格参数名也像返回结构也像。它甚至会告诉你需要access_token需要 POST请求失败时看errcode。这些都太像真的了。所以开发者最容易在这里浪费时间。你不是在调一个错误接口而是在调一个不存在的接口。微信生态 API 不能只问 AI做约球、找搭子、附近球友这类小程序迟早会碰到微信生态能力。小程序登录、订阅消息、公众号模板消息、企业微信、群二维码、客服消息、内容安全、位置能力每个能力都有自己的限制。很多接口还和主体类型、认证状态、服务类目、用户授权有关。这些东西变化也快。AI 可以帮你整理思路但不能替你确认接口存在。尤其是微信和企业微信的 API必须回到官方文档、后台配置和实际接口返回里确认。我现在会把 AI 给的接口建议分成两类。一种是“方向建议”。比如它说可以考虑订阅消息、客服消息、企业微信群、公众号承接。这类建议可以参考。另一种是“具体接口”。只要出现请求地址、参数、权限、回调格式我都会立刻去官方文档核对。不核对就开写风险很高。怎么快速判断有没有被坑我后来会先做几件很朴素的事。先搜官方文档。不要只搜博客不要只看 AI 贴出来的说明。接口是否存在以官方文档为准。再看后台有没有入口。很多微信能力不是有接口就能用还要在公众平台或企业微信后台开通、配置、绑定主体。然后用最小请求验证。不要一上来就封装一堆代码先用最小参数把接口打通。能拿到符合预期的返回再接业务。最后看错误码。微信生态的错误码很重要。很多时候不是代码问题而是权限、主体、类目、白名单、IP 或配置不满足。这几步不复杂但能省很多时间。对 AI 生成代码的态度AI 不是不能用。我现在仍然会让它帮我写脚本、整理参数、解释错误码、对比几种触达方式。它在这些事情上很有用。但我不会让它直接决定接口可用性。尤其是和用户触达有关的能力更要谨慎。约球小程序要做附近球友提醒、乒乓球搭子通知、羽毛球约球消息这些都直接影响用户体验。接口如果不存在最多浪费开发时间接口如果理解错了可能连审核和合规都会出问题。所以我的规则很简单AI 可以给方向接口必须查官方。AI 可以写示例第一版必须最小验证。AI 可以解释错误最终要看真实返回。小结AI 瞎编接口比普通代码 bug 更麻烦。普通 bug 至少有真实边界调试会往正确方向收敛。不存在的接口没有边界你只会一直怀疑自己哪里写错了。做微信小程序、公众号、企业微信这类生态能力时别把 AI 的回答当文档。先查官方再写代码。这个习惯很土但很管用。如果你正在找附近球友、乒乓球搭子、羽毛球搭子或者想发布本地约球信息可以试试小i约球。本文属于「小i约球诞生记」系列。