宜宾接口开发，鉴权这层先做厚后面才省钱

宜宾企业要做接口对接，常见顺序是先写功能后补权限。我的建议反过来，先把鉴权这层做厚。鉴权薄一层，后面补的代价要大好几倍。

鉴权只做一半等于没做

宜宾做批发档口的老板遇到过一次，接口不鉴权，别人能拿到不属于自己的订单。数据本身不机密，漏出去的是哪一批客户，这就够麻烦了。

南广立交附近几个做物流档口的老板也问过同一件事。还有一种情况更隐蔽：鉴权做了，但只在页面那一层做。抓一下接口就绕过去了，谁有空都会试两下。

文档比代码更难补

字段含义、错误码、限流规则三样写清，接手的人不用从头问一遍。岷江新区酒都大道一带的经销商系统也出过同样的事。写文档花的两个小时，能省掉后面一周的解释。

• 每个接口写清谁调、传什么、返回什么
• 错误码列全，别只在注释里提一句
• 限流阈值和重试策略写进文档
• 改接口先改文档，版本号同步

翠屏区和高县的商家也问过同一件事。这套规矩是小程序交付多了以后才写进流程的。不是流程好看，是省事。接手的人少问一句，我们少返工一次。服务客户 300+ 这条我们写进了交付单。这笔账很好算。

日志要留下三样

谁在什么时间调了哪个接口、返回了什么，这三样存下来。日志留半年，短的等于没留。出事那天，日志能省掉一整天的追问。

校验要放在接口这一层

前端藏个按钮不算防护。校验放在接口里，谁绕都绕不过去。我们交付的项目上线前，会用一个普通账号试着越权看一次数据。

接口交付的时候，文档和源码同时给。接手的人拿着这两样，不用再来问我们。问一次是客气，问三次就该收费了。

接口对接的常见疑问

文档要写多细

细到别人不看代码就能调通。写不到的，说明还没想清。接口改一次，文档跟着改一次。

鉴权用什么方式

常见是令牌加签名，具体看对接的是谁家的平台。对接之前先问对方要什么，别自己发明一套。

接口要不要限流

要。不限流的接口，一次异常调用就能把服务打满。规则和重试策略一并写进文档。

老的接口要不要重做

先看有没有越权风险。有就补鉴权，没有的先加日志，别一上来就重写。

总结

宜宾信服无限做接口对接，先把鉴权和文档做完，功能代码反而是最简单的一步。这类接口活，文档跟源码同时交。我们创始人常斌常说，接口是写给下一个接它的人看的，这句我记到现在。真到了同事离职那天，接不上才是真的贵。