S:当我们接到一个产品需求时,需要调用下游服务方提供的接口,比如调用下游 LBS 服务召回附近的商家,这时候需要拉着下游 RD 做技术方案评审,确定下游提供的接口是否满足 PRD 需求。
C:在 PRD 评审时,往往只是 PM 拉着各方 RD 评完了产品功能,RD 需要评估出实现产品功能需要依赖的外部接口有哪些,并整理出技术方案,并敲定所用的外部接口是符合产品要求的。
Q:那么,在技术方案评审过程中,需要接入下游的服务接口时,需要确定哪些内容呢?
A:主要有以下:
- 接口的请求入参字段有哪些?哪些字段是必传的?哪些可以不传,确保必传字段都能拿到
- 接口的性能耗时如何?一般看 tp999 是否满足性能耗时要求
- 下游提供的接口是需要新开发的接口还是已有现成的接口?新开发的接口涉及到接口的联调测试(在 test 环境、st 环境 联调测试),如果是线上已有接口,则直接接入即可,一般不用联调测试了。
- 接口是否支持分批调用?每批 size 设置为多少合适?(如果调用方要求分批的话)
- 接口是否在 test/st 环境支持压测?视部署环境而定
- 如果接口有一些“特殊”参数要传,对接清楚为什么需要传这些参数,了解每个传递的每个参数的含义。哪些是通用参数,哪些是与 PRD 需求相关的参数
- 接口的 response 如何解析?怎样取到当前需求所需的数据?
- 接口是否需要提前开 thrift 鉴权?确保上线前有权限调用