不会看API接口的产品不是好产品。会写API接口的产品八成也不是好产品，究竟咱们时刻那么多，我都花在API接口上，那我的其他才能哪有时刻精进哟。
产品作业中产品研制测验常常说到的一个名词是API接口，接口对接。那么API接口产品究竟要把握到什么程度呢？今日咱们就来揭秘一下研制的产出物-API接口。
1.
什么时分用到接口对接？
2个体系进行交互时运用接口对接。比方说收发单体系（ODS体系）发货单下发wms进行发货，wms要把发货成果给收发单体系。wms是外接的三方体系，咋办呢？还能咋办，API接口对接咯。
在体系交互的过程中，一般产品和研制交流的时分，研制会说推仍是拉，这个是什么意思呢？API接口常见有推送和其他体系过来拉2种方法。就像是我有一个接力棒要给下一个人，那么要么我送到她手里，要么她从我手里来取。
假如是推送，那么对方供给API接口，假如是拉取，那么是我方供给API接口。
2种方法都能完成数据传送，那站在产品的视点怎样选择呢？那就要看通用性，假如收发单体系只对接一个wms，那么咱们体系推或许下流wms体系来拉是相同的。假如收发单体系对几个wms，比方京东wms,百世wms，那咱们就界说一个通用接口，让他们来拉，假如咱们要推，和3个wms体系对接3个接口，那咱们便是3倍的作业量。
2.
接口文档长什么姿态呢？
这个东西要产品出？我这英文还没学好呢。别慌别慌，这个东西不是产品出，研制出的。可是产品要学会看，主要看字段和意义，是否必输。一般产品会和上下流产品对一下接口文档写一下逻辑再给研制进行阐明。
3.
① 留意要测验环境和出产环境。出产上线时分要提示研制换到出产环境调用。
② 留意必输字段和选输字段，要传入字段的意义和校验。枚举值不清楚意义的要问询对方意义，比方说单据类型字段枚举值是B2C发货单，BBC发货单，收购退货发货单等..
③ 留意仅有ID之间的相关，比方说咱们ODS体系的单号是001，到wms体系是否生成了一个新单号A001,那发货回执时分wms要给ODS体系001单号。
④ 留意根底信息的映射。比方说库房代码和对方库房代码是否相同，产品编码和对方产品编码是否相同。假如不相同还要进行映射，那映射的作业是谁来做。
⑤ 留意行信息和明细（咱们常说的list）数据。哪些内行中，哪些在明细中，看的是单据和字段的联系，是1对1仍是一对多，1对1就内行中，一对多就在明细中。比方说发货单只要一个发货仓，那么便是内行中，可是一个发货单有多个产品，那就在明细中。
⑥ 接口文档字段的校验，比方说发货单来了，wms会校验产品是否存在，库房是否存在等，这些校验服务于事务需求，比方说产品都不存在，我怎样发货呢对吧，所以两边体系的根底数据要对齐。
⑦ 同步方法：增量和全量。这个一般在做根底数据同步的时分，比方说产品档案，会员信息等。增量指的是添加的变化的推送给其他体系，全量是守时比方每天推一下悉数的数据。
4.
对接过程中究竟需求多少接口文档？
要根据事务和体系交互流程来看。比方说发货正常场景是发货，发完货之后要把发货成果告知收发单体系。逆向流程是发货撤销，假如发货单你现已给了wms体系，那么发货撤销你也要给wms体系来决议是否撤销。
接口文档（以发货正向流程为例）：
wms供给：接纳发货单接口
ODS供给：接纳发货回执接口
在和研制交流时，研制也常常说到：实时和异步2个名词，这又代表什么意义呢？
实时便是我把数据推过去，对方立马给你反应是接纳成功仍是接纳失利，接纳成功他就会内部进行处理。
异步是对方接纳成功，可是处理是否成功不知道，处理完了之后我再告知你成果。比方说ODS向下丢一个撤销单，wms接纳到了，可是wms说我还要丢给我的下流体系，所以我不能实时给你成果，等下流成果告知我之后，我再告知你是撤销成功仍是撤销失利，所以这个时分ODS还要供给一个接纳撤销回执的接口，wms体系知道成果后再调用我撤销回执的接口告知我成果。当然界说的撤销回执的接口就比较简单了，无非便是单号，撤销成果（枚举值撤销成功或许撤销失利）。没有接纳到撤销成果之前我的单据状况一向处于撤销中状况即可。
说了这么多，总结一下便是产品要知道接口文档中必输和选输字段的意义和运用的意图。
