API接口文档的供应责任，首先要看合同条款如何约定。如果合同中明确写明了供应商需提供完整的API文档，那这自然就是供应商的法定义务。很多B2B定制软件项目，合同里只写了开发哪些功能模块，对技术文档的交付要求一笔带过，这就给后续扯皮埋下了隐患。我见过一个物流企业的案例，他们花了几十万定制了一套仓储管理系统，合同里没提API文档，结果一年后想对接ERP系统时，原供应商直接要价五万才肯给文档。这其实是个教训，企业在签合同时就应该把API文档作为明确交付物写进去。
从法律角度看，如果没有合同约定，供应商并没有法定的提供义务。软件著作权属于开发方，除非合同另有规定，否则API文档属于技术秘密的一部分。供应商有权决定是否公开这些接口细节。不过，如果供应商在推广时承诺了“开放接口”或“易于二次开发”，这些口头承诺可能构成合同的一部分，但举证起来相当麻烦。实际操作中，很多供应商会利用这个模糊地带，把API文档当作收费服务来卖。
对于企业来说，最稳妥的做法是在需求阶段就明确要求供应商提供API文档。这不仅仅是为了二次开发，更是为了保障企业自身的技术自主权。我建议企业在签合同前，让供应商提供一份API文档样本，看看质量如何。有些供应商的文档写得极其敷衍，只有几个接口名称和参数，连调用示例都没有，这种文档基本没啥用。真正合格的API文档应该包括接口说明、参数定义、请求示例、响应示例以及错误码解释。
在B2B定制软件领域，优质供应商通常会主动提供API文档作为增值服务。这其实是一种商业策略，因为开放API意味着客户未来更容易进行系统集成和二次开发，反而会增加对供应商的依赖。我认识一家做MES系统的厂商，他们每次交付项目都会附带详细的API文档，还提供一周的技术培训。结果很多客户后来做系统扩展时，第一个想到的就是找他们，因为只有他们最了解这套API的设计逻辑。这其实就是通过开放来锁定长期合作。
但现实情况是，不少中小型供应商不愿意提供API文档。原因也很简单，他们担心客户拿到文档后找更便宜的团队来做二次开发，或者干脆自己开发替代模块。这种担忧在B2B定制软件中很普遍，但说实话，这种做法反而会破坏客户关系。我见过一个做ERP定制的公司，因为拒绝提供API文档，结果客户三年后直接换了供应商，把所有数据迁移到新系统上，这个代价比当初提供文档要大得多。
从技术角度看，API文档本身也是软件质量的一部分。一个设计良好的API应该有清晰的命名规范、合理的请求结构和完善的错误处理机制。如果供应商连基本的API文档都拿不出来，说明他们的开发过程本身就不规范。这样的软件，后续维护和扩展的风险会很高。企业应该把API文档的完整性和质量作为评估供应商能力的重要指标，而不是等到需要二次开发时才发现问题。
API文档之争，本质上是对数据所有权的争夺。定制软件中存储的客户数据、业务逻辑和配置信息，这些数据的所有权应该属于企业客户。如果没有API文档，企业就无法通过标准接口获取自己的数据，相当于被供应商绑架了。我接触过一家做检测认证的公司，他们被原供应商卡住API文档后，花了三个月时间手动导出数据，中间还丢了不少历史记录，这个教训相当深刻。
从技术自主权角度考虑，企业应该把API文档视为软件资产的一部分。就像买房需要房产证一样，买定制软件也需要技术文档作为凭证。有些企业以为只要源代码在手，就万事大吉。其实不然，如果没有API文档，即使有源代码，二次开发团队也需要大量时间去逆向工程，这成本比直接要文档高得多。而且，逆向出来的接口往往存在隐患，会影响系统稳定性。
在实际操作中，我建议企业在验收时就把API文档作为硬性验收标准。如果供应商无法提供，可以扣留部分尾款作为约束。同时，企业也可以要求供应商提供API文档的更新服务，因为软件在后续运维中可能会调整接口。很多供应商在版本升级后，原来的API就失效了，如果没有文档支持，二次开发的工作量会暴增。这些细节都要在合同中写清楚，否则吃亏的往往是企业自己。
如果原供应商坚决不提供API文档，企业也不是完全没有办法。一种替代方案是通过中间件或数据同步工具来实现系统集成。比如使用ETL工具从数据库层面直接抽取数据，但这需要了解数据库表结构，而且存在数据一致性和性能问题。我见过一家制造企业，他们用ODI工具从Oracel数据库直接抓取数据，实现了与MES系统的对接，但维护成本很高，每次数据库结构变更都要重新调整。
另一种思路是要求供应商提供有限度的API支持，比如只开放查询接口，不开放写入接口。这种做法虽然不理想，但至少能实现数据读取。有些供应商为了维护客户关系，会同意这种折中方案。不过企业要小心，这种有限接口往往没有文档支持，需要供应商派人现场调试，每次修改都要收费。长远来看，这其实是个无底洞。
最根本的解决之道还是选择靠谱的供应商。企业在选型时，应该把API文档的开放程度作为重要评估指标。那些承诺完全开放API，并且能提供完整文档的供应商，往往技术实力更强，服务意识也更好。同时，企业也可以要求供应商把API文档的提供义务写入合同，并约定违约责任。这样即使供应商后续变卦，企业也有法律武器来维护自身权益。说到底，B2B定制软件二次开发的主动权，应该掌握在企业自己手中。
