查看原文
其他

系统型产品接口设计方法总结

岚天 产品刘 2022-10-16

作者:岚天 来源:简书

现在社会都在将谈论“共享”,很多我们接触的APP中,要完成所有的业务流程多少都需要和第三方产品进行对接,使用第三方已完成的功能。

举个简单的例子:现在几乎所有的APP注册都是使用手机号进行注册,为了验证手机号为操作人本人所使用,都会发送一条短信验证码。这个时候,基本上发送短信的业务就使用到了第三方短信平台来完成。所以作为产品经理必须要了解,如何进行对接,要传什么信息给第三方平台,第三方平台处理完成业务后,所返回的信息我们应该如何处理等。

在此,我就简单的做个总结,让各位刚入行的产品经理们知道如何进行多系统对接。首先,从了解基本名称出发;其次,了解设计的方法;最后案例解说加深大家的理解。

一、了解名词及作用

1.   名词解释

  • 软件接口:程序组件间对接的出入口。

  • 页面跳转同步通知:如果一个进程在执行请求时,该请求需要一段时间才能返回信息,那么这个进程就会一直等待下去。通俗点就是有先后顺序,必须先完成前面事务才能做后面事务。

  • 异步通知:进程不用等待可以继续执行下面的操作。背后信息传输,不分先后。

2.   接口作用

由架构师将整个系统架构搭建出来,各个子系统或者各个模块之间通过接口进行调用,可以让整个系统拓展性增强。

各个子系统或各模块之间信息传输必须要进行一定的安全验证,保证信息传输的正确性。

3.   接口的组成

接口常常成对出现,有请求参数和返回参数。

请求接口一般必须包括两个部分:基本参数、业务参数

  • 基本参数:接口名称、身份认证参数(即对接的模块或系统ID、签名、密钥等)

  • 业务参数:该接口所有提供的服务或者所要达到目标的业务信息。

4.   同步、异步一般传值情况

同步:主要作用于页面跳转,传值信息主要将页面所要处理的最关键信息传输即可。

异步:是为了强调给对接的模块处理业务信息,传值信息根据实际情况尽可能详细一些,但是必须和本接口设计的目标一致,不要传输太多无用的参数。

二、设计的方法及选择

1.   接口设计的方法

第一种:外部调用方call本系统的接口,同步返回请求成功,但实际操作是本系统延后去执行的,异步返回处理结果。

  • 发起方:用户

  • 优点:外部调用方不需要等待业务处理结果,可以进行自身其实业务处理。

  • 不足:当外部调用方未能及时处理异步通知结果时,有可能会导致自身业务会存在一些风险或用户体验度不足。为减轻不足之处,此方式的接口设计,需要另外再设计一个查询业务处理结果的接口。

第二种:外部调用方call本系统的接口,业务处理完成后直接返回处理结果。

  • 发起方:商户/外部调用方

  • 优点:外部调用方必须等到本系统业务处理完成后才能继续进行自身系统的业务,可以避免存在遗漏的业务未处理。

  • 缺点:外部调用方必须等待业务处理结果,前台用户也会看到等待页面,增加了用户的焦躁感。

2.   接口设计方式的选择

接口要为需求服务,在接口设计时的思考步骤:

  1. 回归产品的最初定位

  2. 设想业务场景,选择最优的用户体验方式。

  3. 根据最优的用户体验方式绘制业务流程。

3.   示例-广电公共账户充值

3.1.需求描述

  • 为SP提供广电公共账户充值服务,该服务属于独立的功能模块。

  • 用户进行业务订购,当公共账户余额不足时,需要充值账户余额后进行订购。

3.2.分析思路

1.定位:充值服务、独立功能模块。

2.场景设想:

3.场景选择:通过以上场景设想描述分析得出,场景二对于用户来说操作步骤会比较简单,可以最快的达到最初的需求目标。

4.接口设计方式选择:第二种方式

3.3.绘制业务流程

总结

在进行多产品系统对接时,在接口设计方法各有优劣势,采用何种方法进行设计最终还得回归到产品的特性,需考虑到产品运行的环境、产品定位、使用场景、团队技术水平情况等多方面考虑,去选择合适自身产品的方法。

帮助你成长

我之前也创立过产品经理学习交流群,那个时候由于人数少,大家讨论也蛮积极的,但是微信群讨论的一大弊端就是无法将谈论的知识提炼出来,干货内容渐渐被口水话淹没,所以我建立了一个知识星球(原小密圈),在这里我会分享自己的思考感悟,你有问题可以随时像我发起提问,同时别人提的问题你也能看到,更重要的是你不论什么时候看这个回答它都在!

同时大大老师以后所有的live,小密圈的同学都可以免费学习。

知识星球规则:

1、返还费用:为了保证社群的质量和活跃度,需要先付款68元,连续签到3天返还20元,连续签到5天返还30元,连续签到7天返还50元。

2、签到形式:可以是你的产品感悟,也可以是你学习中遇到的问题,也可以是你回答别人问题。(把你的感悟记录下来,把你遇到的问题提出来,帮助解决别人遇到的问题,这个过程就是成长,切记不要潜水,好歹你也是付费进来的)。

3、奖励:每周抽取最活跃的用户,(提出的问题+发表的产品感悟+回答别人问题)总数最多,即有可能获得现金红包、PRD文档、面试简历模板、原型文件等不同奖励形式。

奖励凭证:

邀请5个小伙伴加入,则本人加入的费用免除,并同时获赠68元现金奖励,当让为了保证群质量,邀请的小伙伴需要付费加入。

4、广告:社群内禁止发广告,否则即使付费,也要被T出去,如果想发广告,加入上课群,并红包走起,想加入上课群,加微信yw5201a1,拉你入群。

5、干货示例:下图是知识星球小伙伴讨论的部门干货内容

之前付费进入产品经理学习群的小伙伴,可以加微信(yw5201a1),免费拉你入群。

报名方式:长按二维码付款后加微信yw5201a1,拉你入群。

往期精彩文章

产品经理必知的运营那些事

产品实习生需要具备的能力

产品设计心理学的应用

如果你想系统的学习请戳原文链接

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存