4个真实案例,看接口文档的设计要点( 五 )

4个真实案例,看接口文档的设计要点

这样的设计有个很大的问题是,供应商的状态客服系统并没有。假如在预先实现时,根据现有状态值双方约定好,但随着SRM系统的发展,当供应商的状态值变更或新增时,存在两边数据不一致和获取不到数据的隐患,所以这样的设计不能不说容错性是很低的。

(2)既然客服系统没有状态值,那它只根据商品编码来获取,我将供应商及其状态都返回给它不就可以了,为此我的第二版设计是这样的:

4个真实案例,看接口文档的设计要点

这样的设计其实跟第一版有同样的问题,即使将状态返回给它,它因为不知道这些状态的业务意义,也就无法过滤掉那些没用的数据只给客服人员展示有效的信息。

(3)经过两版分析,我的第三版设计如下:

4个真实案例,看接口文档的设计要点

推荐阅读