产品经理如何处理系统对接（API对接）类需求？ 对接保险公司接口工作内容怎么写

一、什么是系统对接类需求？

系统对接，是指两个或多个系统间进行数据交互（系统间一般通过API接口来实现数据交互）。所以，需要与其它系统进行数据交互，才能实现的需求就是系统对接类需求。例如：订单系统将订单推送到仓储系统进行打包发货，电商前台系统支付时调用支付宝接口进行支付，电商前台系统显示物流追踪状态等都是通过接口实现数据交互的，都是系统对接类需求。

二、为什么要处理这类需求？（一）系统的价值所在

系统间进行数据对接后，能够实现高效的处理流程，减少失误率，降低人工成本。比如：拿用户在速卖通平台下了单，商户将订单交给物流公司发货，并将物流单号回传到平台这个常见的业务流程来举例

情况一：未实现系统间自动对接

1、商户在速卖通后台看到了用户下的订单，将订单导出

2、将导出的EXCEL进行调整，使其满足物流公司下单模板，在物流公司后台，进行导入下单

3、将运单号从物流公司后台中导出

4、将导出的运单号excel调整，再导入到速卖通后台

情况二：商户有自己的ERP系统，ERP系统与速卖通平台和物流公司都进行了系统对接，商户只需进行如下操作：

1、系统自动同步/点击【订单同步】按钮，批量下载订单

2、选择发货的物流方式，点击【推送】按钮，将订单推送到物流公司

3、商户可批量同步运单号到ERP系统

4、获取到运单号后，ERP系统自动回传单号到平台

可以很明显的发现，情况一，效率低下，容易出错；而情况二则效率高，降低了人工失误的概率。

（二）系统对接类的需求越来越普遍

1、越来越多的企业引进计算机系统，以前线下处理的，现在只要有一点规模的企业，都会引入系统；有条件的自己开发，无条件的找第三方软件；

2、企业间的合作越来越普遍，越来越多的企业开放了接口

3、接口对接技术更成熟，安全性越来越高。如：认证流程大多使用Auth2.0版本，无需用户提供账号密码或者key即可获取token

三、如何处理系统对接类需求

系统对接类需求也是需求，所以跟一般需求的产品设计流程是相同的，只是增加了接口研究部分

第一，需求分析

1、了解业务背景和业务流程，确定问题所在

产品经理一定要针对具体的问题来设计方案和功能，这样才能对症下药，真正的解决需求方的问题。而了解了业务背景和业务流程，可以让我们更准确的确定问题所在，同时不只局限于问题所在的点，而是整体上看待问题，有利于给出最优的解决方案。

2、明确需要达到的目标

在了解了问题后，需要明确我们需要达到的业务目标，目标不同，方案也会不同。例如：公司有一项新的业务，线下已经在开展了，但是处理效率低，且经常出错（此业务涉及第三方系统）。目前系统中无此业务的相关功能，那我们的目标是业务流程走通？还是既要走通，又要实现完全的自动化对接？若目标为前者，则需要设计人工补录等功能；若是后者，则需设计接口对接的正向、逆向流程等。

3、评估方案的投入/产出比

评估方案的投入和产出比，决定需求是否要进行处理、以何种方式处理以及处理的优先级。投入主要指的是研发的时间和人员，一般会折算为金钱；产出指的是功能开发后，能产生的价值是多少，一般也会折算为金钱。例如：某个平台A的订单量每天出几单~几十单；另一平台B的订单量每天出几百单。那我们会优先处理B平台的订单处理的需求，并实现自动化对接；而A平台的需求会延后处理，且会以人工补录的方式，以降低其投入成本。

第二、确定功能点

确定满足需求目标的功能点。值得注意的是，这里的功能点比较宽泛，后面再进行细分，如：新建订单、订单处理、包裹处理等

第三、整理各种流程图

1、业务流程图

将业务的处理流程以及每个处理节点涉及哪些角色，通过流程图的方式表现出来就是业务流程图。业务流程图能帮助产品经理更快的定位问题点，以便找到最优解决方案。业务流程图给一般的业务人员也是可以看懂的。

2、功能流程图

相比于业务流程图，功能流程图更加具体，主要是功能的操作与流转，以实现业务目标。功能流程图主要是给开发和测试人员看的。PS：偷懒的话，一般功能流程图与数据流程图可以放在一起

3、数据流程图

（1）研究接口文档

I 接口是什么？

API，全称是ApplicationProgramming Interface，即应用程序编程接口，我们日常中习惯简称为“接口”。接口是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

简单理解：接口是数据传输的要求和规范

II、 接口的基本类型

A、调用型

对方提供，我方触发，对方接收并返回响应的数据。一般是新增、删除、查询时，使用该类型的接口。

B、推送型（订阅消息）

我方提供地址，对方触发，我方接收。一般是对方数据到达特定状态后，给我方发送消息，如：发货后，发送消息告知我方。

III、产品经理为什么要看接口

A、使得产品方案更加合理，可行

a、了解接口输入和输出参数，清楚要提供哪些数据和得到哪些数据。例如：创建运单的接口，必须要提供收货人，发件人，物流渠道等信息，能得到的就是运单号

b、接口参数中定义了必填项和选填项，根据公司的业务情况，决定哪些字段要用户必填？哪些用户选填？哪些是不变的，需要系统写死？

B、对项目的开发量认识更准确，便于准确安排项目进度

C、与研发的沟通更顺畅，沟通成本更低

IV、 接口文档怎么看？

A、确定接口文档中各个方法实现的功能点，根据需求确定需要使用的方法

B、确定接口是调用型还是推送型，明确开发的实现方式，有利于确定开发的具体工作量

C、整理输入参数，确定哪些字段必填，哪些字段在什么情况下必填--以便确定页面中各个字段的呈现逻辑

D、整理输出参数，确定这个接口我方能拿到什么数据，这些数据是不是业务方需要的，以确定是否可实现相关需求

以WishPOST举例（wish邮接口地址）：

1、接口文档的左侧为接口的方法名称

2、中间为输入参数和输出参数的说明。输入参数一般会注明参数名称、类型、长度、描述、是否必填等信息；输出参数一般会注明参数名称和描述

3、右侧为请求示例，此部分方便开发进行数据传输格式的选择，如XML还是Json等

4、返回参数

V、如何利用postman调试接口（postman下载地址）

A、确定调用的接口

B、填写调取的API端点，并确定获取方式（GET还是POST）-接口中有说明

C、确定数据传输格式，并传入指定参数

PS：比较常见的是XML和JSON，在Body-->raw中上传；还有些是x-www-form-urlencoded格式，需要在Body-->x-www-form-urlencoded中上传，根据接口定义进行选择即可

D、点击Send按钮，查看返回结果

以WishPOST进行举例：

token获取：目前大部分系统都采用Auth2.0模式来获取，