API 定义的局限性
简而言之：什么是 API 定义
API 定义描述了一个 API 的结构：可用的端点、请求/响应格式、认证方式、速率限制，以及字段的文档化含义。在自动化外汇交易场景中，它还可能包括价格或交易操作在消息中的表示方式（例如，时间戳的含义、如何发起订单请求，以及可能返回的状态）。
API 定义之所以有价值，是因为它将稳定的机制（接口应接受和返回的内容）与可变的条件（市场行为和执行过程）分离开来。
API 定义如何工作——以及它无法控制的部分
当你实现一个 API 集成时，你会依赖定义来解释输入和输出。这减少了软件行为的歧义，但并不能控制：
- 实时数据状况：不能假定市场数据的准确性和完整性。
- 提供商和基础设施行为：网络延迟、服务器负载、重试机制和速率限制都会影响响应时间。
- 执行机制：成交、部分成交和拒绝原因取决于流动性、订单类型规则以及经纪商/交易场所的政策。
- 司法管辖区和合规限制：允许的请求可能因账户权限和当地法规而异。
即使接口实现正确，“相同的请求”在不同市场环境下也可能导致不同的结果，因为 API 定义通常不保证市场条件的一致性。
实证与常见失败模式
考虑一个系统解析 API 返回的“订单状态更新”。一种常见的失败模式是假设状态转换每次都意味着相同的执行质量。实际上，状态更新可能比预期更晚到达、顺序错乱，或反映的是仍存在未平仓风险的部分结果。
另一个例子是与价格相关的字段。如果你的逻辑假设显示的价格代表决策时刻的稳定参考值，那么当市场价格变动速度超过消息传递速度，或价差和流动性发生变化时，系统可能会误判。如果你使用历史关系（例如变量之前的关联性），这并不能证明相同的关系在未来仍然成立。
这些并非定义本身的缺陷，而是文档化接口语义与不可预测的真实世界交易条件之间的差距。
主要局限性与风险
API 定义的关键局限性在于不确定性和不匹配：
- 接口 ≠ 结果：文档可以定义应发送的内容和可能返回的状态，但无法保证订单会按预期成交。
- 假设必须明确：如果你对延迟、成本或滑点建模，必须明确说明假设（例如预期延迟范围和费用处理方式）。没有假设，计算就无法验证。
- 历史 ≠ 未来：在新的波动性、流动性、价差或执行条件下，历史模式或回测行为可能会失效。
- 提供商的可变性：成本、执行规则和数据新鲜度可能随时间变化。即使定义保持稳定，你的运行环境也可能发生偏移。
验证与后续问题
由于 API 定义并非预测工具，验证的重点应是你的集成假设是否与实际观察到的行为一致。独立检查你的 API 在压力条件下（延迟、速率限制、请求被拒）的返回情况，并验证你的系统是否正确解析时间戳、状态和错误消息。
一个有用的后续问题是：你的工作流程中哪些部分依赖于实时假设（价格新鲜度、订单时机和执行质量），哪些部分仅依赖于稳定的接口语义？系统对可变市场或运营条件的依赖程度越高，“定义准确性”本身就越难降低不确定性。