API 沙箱

沙箱环境与真实 API 的运行方式相同，但不会造成任何实际后果：不会收取费用、不会发送电子邮件、不会发货。支付服务提供商、银行和物流公司都提供沙箱服务，以便用户可以在无风险的情况下构建和测试集成。

工作原理

沙箱通常拥有自己的基础 URL 或凭证、种子数据和测试值，这些值会触发特定的结果——例如，始终会被拒绝的卡号或始终会超时的金额。一个开发者的沙箱中的数据与其他开发者的沙箱中的数据相互隔离，并且可以重置为已知状态。

误解

在沙箱环境中通过测试，意味着在生产环境中也能通过测试。沙箱环境简化了操作：它们跳过欺诈检查，即时批准，使用宽松的速率限制和旧版本的 API。将沙箱环境视为测试行为规范的场所，并保留少量生产环境的冒烟测试来验证两者之间的差异。

点击这里试试

这里的每个请求都通过 X-Sandbox-ID 标头进行隔离，因此您的写入对其他人的测试是不可见的；您可以从任何文档页面或使用 POST /api/_reset.

相关内容

• How caller data is isolated
• 赝品、存根和假货

资料来源

• Mocks, stubs and test isolation — Martin Fowler

其他术语

• 赝品、存根和假货 — 三种类型的测试替身——真实依赖项的替代品——它们在执行的操作和检查的内容上有所不同。
• 模拟 API — 一个可以替代真实 API 的方案，它能够返回逼真的响应，但背后却没有真实的系统支持。
• 测试夹具 — 测试开始时的已知数据和状态，每次运行都以相同的方式设置。
• 合同测试 — 测试 API 及其使用者是否在请求和响应的形式上达成一致，而无需同时运行它们。
• 烟雾测试 — 在进行任何更彻底的检查之前，先运行一组简短快速的检查，确保最重要的路径都能正常工作。
• 不规则测试 — 一个测试，有时通过，有时失败，而测试的代码没有任何改动。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日