JSON Schema与GitHub API最佳实践提供结构和接口处理参考。以下为一般企业集成设计,不意味着所有接口具有相同规则。
数据约定写到具体字段
模拟库存查询,需要确认库存是可售、实物还是已扣预留,时间字段按哪个地区解释,以及空值是什么意思。客户业务人员与系统维护者共同确认,FDE把这些含义写入映射说明。
样例包含分页与错误响应
少量数据返回成功可能掩盖漏页。测试需要覆盖多页、空结果、权限不足和限流,记录最终取得的记录范围。重试方式按目标系统要求设置,不无界并发读取。
变化发生时允许明确失败
未知字段或结构不符时,先进入待核状态,不自动拼凑结果写入业务。交付包含版本、错误说明和责任人,客户能够判断是数据变化还是连接器故障。本文不提供任何具体系统的完成验收证明。
延伸阅读:FDE案例。