有老板遇到对接故障,两边互相说是对方的问题。我说先别争,先把问题定位在哪一段,责任自然就清楚了。扯皮的成本,往往比修问题还高。客户开口就是一句问,系统对接责任到底要不要上。先做客户能马上感受到的那一步。
先定位是哪一段出的问题
系统对接涉及两方甚至三方,出问题的可能是任何一段。不定位就争,等于两个人隔着门吵架。
我们的做法是先看请求走到哪一步断的:请求发出去了没有、对方收到了没有,还有对方处理了没有。这几步一看,范围立刻缩小。
定位靠的是日志。所以对接之前就要约定好,两边都要留着调用日志,出了问题各自能查。
合同里要写清楚边界
对接的责任边界,最好写进合同或者方案里。写清楚哪一方负责什么,出了事不用临时商量。
常见的约定是:谁提供的接口。谁负责接口本身的可用性;谁调用的谁负责调用逻辑;数据口径以哪一方为准。
还有一条容易被忽略的是响应时间。接口出问题,多长时间响应、多长时间修复,也建议写进去,别只写「尽快」。
留日志是保命的
对接出问题时,最有力的证据是日志。有日志,三分钟能定位;没日志,三天都在猜。
我们的建议是对接双方都保留至少一个月的接口调用日志。包括请求内容、返回结果,以及时间戳。日志要能按请求号串起来。
日志还有一个用处是复盘。故障修完之后,翻日志看看是哪个环节薄弱,把流程补上。不然同样的故障还会再来一次。
还有一个是变更。接口升级、字段调整这类变更,提前多久通知对方,也要约定。突然改接口,对方系统直接报错,客户那边立刻能感觉到。
对接责任怎么分,客户常问这几件事
对接出问题怎么快速定位
看请求走到哪一步。用请求号把两边的日志串起来,很快能锁定范围。
对方不认账怎么办
拿日志说话。所以日志要提前约定保留,别等出事才想起来没有。
故障期间客户的损失谁承担
按合同约定。这也是为什么要把责任边界提前写清楚,临时商量往往谈不拢。
这话听着扫兴,但常斌的团队会讲:对接故障最贵的不是修。是两边谁也不认,客户在旁边等。
先把边界划清楚
我的建议是开工前把责任边界和响应时间写进方案,双方签字确认。边界清楚了,后续的合作才顺。
一千多名学员是我们带出来的,一线踩过的坑比书上多。做系统对接这种事,信服无限会把边界写进方案再动手。定方案之前,告诉我这次对接涉及哪几方,我们帮你把边界列清楚。出事的时候不用吵,一次说定,先列清单,往后合作也顺,这事不难,就是得先说明白。