B端产品不得不知的API接口
API接口对于B端产品经理来说是个再熟悉不过的词汇了。虽然它是技术范畴的东西,但作为B端产品经理如果不懂得它的使用场景和解读方法,在实际工作中是很难顺利完成产品方案的。因此本文将重点探讨API的使用场景,及在不同场景下产品经理如何解读API接口去顺利完成产品工作。
一、API接口是什么
“接口”这一词应该是B端产品经理日常和开发沟通最多的词汇之一了,经常听到接口文档、接口联调等等。API接口的定义是一种规范或约定,用于描述软件系统中不同组件之间的通信协议和数据交互方式。API接口定义了一组可用的操作、消息格式、数据结构和参数,以及双方之间如何进行通信和交互。通过API接口,软件系统的不同部分可以相互调用和协作,实现数据的传递、功能的调用和共享资源的访问,同时保持系统的安全性和稳定性。(一堆官方废话,先不用管往下看)
接口在形式上由四部分构成:方法(get,post等)、url(请求地址)、请求参数、返回参数
在功能实现上由三个主要部分构成:输入,逻辑处理,输出。(产品需要关注的)
二、API的主要作用
2.1 前后端数据传递和功能调用的桥梁
接口联调是前后端开发工作中很重要的一部分,现在都采用前端后端分离的开发模式。通常来说在接收到产品需求后,后端会先定义好接口文档给到前端,前端在完成界面展示的代码编写,后端完成了接口的逻辑处理就需要开始进行联调,以确保接口能够从输入到输出的正常运作。
以新增客户为例:新增客户接口的功能就是把用户输入的客户信息写入到数据库中。接口输入:客户信息。逻辑处理:是否可以新增成功?(这里面涉及的规则就需要产品经理来确定)输出:返回前端处理结果。
产品涉及工作:接口在前后端的应用一般不需要产品经理特别关注接口本身,产品经理需要重点关注的是规则的制定。也是后端经常跟我说的实现肯定是可以实现,但你要定个规则给我。
2.2 系统对接
在B端工作中经常会涉及到跨系统的需求对接,比如我从事的供应链金融领域会经常涉及到与资方进行系统对接共同实现客户的借贷全生命周期的系统流程。那么跨系统交互的重要工具正是API接口。下图为我司查询客户授信结果流程图和接口(输入:客户编号 逻辑判断:客户是否满足授信通过规则 输出:客户授信状态、授信时间等)。
产品涉及工作:在系统对接需求中,可能就会涉及到产品经理对于接口的应用。重点需要关注接口中的请求参数和响应参数。
例1:资方需要我们在客户授信流程中提供客户信息,那么资方会出具一份客户授信信息接口,产品经理就需要明确这份接口中资方想要的是哪些字段信息,我们在系统什么节点调用此接口,这些信息如何获取等等。
例2:上述例子是需要产品向外部系统提供数据,那么反过来也会涉及到向外部系统要数据。那么往往有时候我们会发现外部提供的接口字段数据无法满足我们实际的业务要求,比如授信结果通知中不告诉客户的授信到期时间,那么运营过程中就无法提前对客户进行贷后处理。这时就需要我们去跟外部沟通增加或删减字段。
例3:内部跨组合作。风控组的需求经常会涉及到取金融组的数据。比如需要获取客户的在贷状态。由于数据是金融组的,一般就需要金融组配合开发提供此功能接口。产品经理需要做的就是制定规则,在贷状态有哪些?每种状态的取值规则是什么?至于接口具体如何定义,如何实现与我们无瓜。
2.3 共享资源
相信大家都听过避免重复造轮子。其实就是要通过封装接口去避免同样的功能重复开发。比如你要做一个打车平台需要在APP上显示地图,那么如果从0到1开发一套成熟的地图系统的时间成本和资金成本是巨大的。
但是已经有成熟的百度地图为我们做好了,只需要在需要的时候调用他们的接口即可。这在B端行业中是非常常见的,经常需要调用第三方服务商的接口去满足业务需求。
以我司为例,在风控系统中就需要每日定时获取第三方服务商天眼查、百融(企业、个人数据提供商)的接口数据。这些数据我们自己内部是肯定很难获取到的。因此会按照接口调用次数去付费合作。
在读取接口文档时要注意Array字段类型,Array是数组字符类型,可以理解为会有多条数据。那么在展示的时候通常就需要设计成列表形式的,而不能当成是一条数据去进行原型设计。
写在结尾
现在大家可能会比较理解定义中写到的“API接口的定义是一种规范或约定,用于描述软件系统中不同组件之间的通信协议和数据交互方式。API接口定义了一组可用的操作、消息格式、数据结构和参数,以及双方之间如何进行通信和交互。通过API接口,软件系统的不同部分可以相互调用和协作,实现数据的传递、功能的调用和共享资源的访问,同时保持系统的安全性和稳定性。”这一段话了。
在B端产品经理的实际工作中掌握接口的定义及使用场景还是很有必要的。
以上是个人对于产品经理眼中的接口的总结,欢迎大家补充指正。有有补充的特别好的我会重新更新文档上传。
本文由 @B端阿超 原创发布于人人都是产品经理。未经许可,禁止转载
题图来自Unsplash,基于 CC0 协议
该文观点仅代表作者本人,人人都是产品经理平台仅提供信息存储空间服务。
- 目前还没评论,等你发挥!