北京
第三方应用程序接口集成是商业软件里最容易被低估的工作。文档读起来很清楚，供应商发布了客户端库，有人开口就是两周。六周之后，团队还在争论一个已经退款的订单收到两次网络钩子通知时该怎么办。
这种差距不是能力问题。集成里真正麻烦的部分从来不是请求和响应，而是另一个系统做出文档从未描述过的行为时发生的一切。它一定会发生，因为那是一个由别人维护的在线产品，对方有自己的路线图，没有义务配合你的发布计划。
经验法则：不同集成类型的时间成本相差一个数量级
只读集成从单个服务拉取数据，通常需要一到三周。写入事务的集成需要三到六周。两个系统都允许编辑的双向同步需要六到十二周，而且从未真正结束，因为冲突解决本质上是穿着工程外衣的业务问题。
估算都来自顺利路径，而顺利路径大约只占全部工作的五分之一。写一段获取客户记录、映射到模型并保存的代码，一个下午就够了。然后现实开始介入。
令牌过期、限流响应、字段类型不一致：集成的日常天气
令牌在批处理中途过期。供应商返回限流响应，却没有提示这个限制是按天计算而不是按分钟。文档说某个字段是整数，结果一个遗留账户返回的是字符串。分页把一条记录返回两次，因为读取期间另一个用户编辑了它。沙箱环境接受了生产环境拒绝的负载，因为沙箱上次更新还停留在2023年。
这些都不是罕见情况，而是集成工作的日常天气。每一个都会变成一个必须有人做出并测试的设计决策。做过这类工作的团队从一开始就为这些情况构建。没做过的团队会在生产环境里一个一个发现，通常是在周五。
估算之前，先确认你实际在构建哪一种集成
第一种和最后一种之间的差距大约是一个数量级。只读拉取是定期从另一个系统获取数据并存储或展示，失败可以通过重试恢复，漏跑一次也不会破坏下游数据。这是最便宜、最可预测的一类。
事务性写入是发送会改变别处状态的内容：支付、订单、发货预订、支持工单。此时正确性变得重要，因为重复或丢失的请求会带来财务或合同后果。幂等性、对账和清晰的失败处理从可选项变成必选项。
事件驱动消费是另一个系统在事情发生时通知你，通常通过网络钩子。这种方式高效，消除了轮询延迟，但也引入了一整类围绕投递保证和顺序的问题。
特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
