小i约球诞生记08：AI 瞎编接口，比写错代码更坑
本文是「小i约球诞生记」系列文章之一。
小i约球是一个微信小程序，主要帮乒乓球、羽毛球、台球、网球爱好者找到附近合适的球友。本文从一个具体技术或产品问题切入，记录约球小程序从 0 到 1 过程中的设计取舍。
小程序：微信搜索「小i约球」
前言
这篇聊一个很烦的坑：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约球诞生记」系列。
项目官网：https://iyueqiu.cn 微信小程序：搜索「小i约球」
