接口对接成功率怎么看,不能只看网关是不是绿的。HTTP成功只说明报文送达,业务成功才说明库存、订单或运单按单据改对了。接口对接成功率,指的是在约定统计窗口内,业务单据被对端正确处理后的比例,需要与技术可达率、校验失败率和账实漂移分开看。
第一批写过对接费用怎么估,本篇写上线之后怎么判断接口健康。幂等篇谈的是重复到达不二次改账,本篇谈成功如何度量。通天晓可以提供回传结果,监控口径仍要在项目里定义,本文不把某个百分比写成必须达标的行业标准。
三种率,不要加总成一个数
| 指标 | 含义 | 单独看会误判什么 |
| 技术成功率 | 网络、认证、网关返回成功 | 报文成功但业务拒绝,仍显示健康 |
| 业务成功率 | 单据被接受并完成目标状态 | 忽略大量主数据校验失败 |
| 对账一致率 | 日终双方单据集合一致 | 当天率高、隔夜漏单仍在 |
管理看板应三列并列。只盯技术成功率,业务拒绝会被当成“系统稳定”。只盯业务成功率,会把对方校验过严当成己方故障。对账一致率用来抓漏推和重复推,不能用成功率曲线代替。
怎么统计才有决策价值

按单据统计,不按原始调用次数。一次超时重试三次,分子分母要按业务键去重,否则成功率被重试稀释或虚高。分接口看:出库回传、库存占用、取消单、运单下发,失败影响不同,不要合成“对接总成功率”。
失败要分类。主数据不存在、权限不足,应进校验失败,不进无限重试。超时、对端5xx,进技术失败并重试。业务键冲突或状态不允许,进业务拒绝。通天晓的通天晓仓储管理系统和通天晓OMS系统适合回写处理结果码;没有结果码,成功率只能靠猜。运输回传另算一列,交给承运或通天晓运输管理系统的节点,不要和库存占用混在一张成功率里。
看率之外还要看什么
时延可以看,用来发现积压,但不替代成功率。积压队列长度、死信数量、人工改账次数,往往比率更能解释事故。3PL多货主应能按货主或货主接口过滤,一个货主证书过期不应把所有货主的率拉垮后无人认领。
阈值由合同或内部SLA约定。本文不引用第三方博客里的99.5%当标准。资料和口径说明截至2026年9月。
FAQ
HTTP一直200,库存还是会漂吗?
会。200只表示收到了。对端用成功包装业务拒绝,或只更新了日志没改账,技术率仍然漂亮。要以目标状态和对账为准。
校验失败要不要算进成功率分母?
要单独列。算进业务成功率会逼仓库放松主数据;不算进任何率又会让脏数据无限重试。正确做法是校验失败率独立告警。
成功率高但对账对不上,信哪个?
信对账。成功率看的是当时返回,对账看集合。漏在重试队列外的单,当时可能根本没进分母。
通天晓会提供现成的对接大盘吗?
能提供处理和回传结果,大盘字段和阈值要项目配置。不要把演示环境的绿屏当成生产成功率。
要不要把P95时延写进验收?
可以写,但先写业务成功和对账。时延很好、状态错了,验收仍应失败。
总结
接口对接成功率要看成业务成功、技术成功和对账一致三列,而不是一个绿灯。按单据去重、按接口拆开、按失败分类。通天晓适合给出回传结果码,口径仍由项目定义。需要对照系统回传能力时,可访问通天晓官网,用一天失败分类日志做核对。