CodeBuddy接口调试如何配置沙箱提升安全性

CodeBuddy调试接口必须启用沙箱模式隔离生产环境，步骤为：进入API调试→点击目标接口调试→切换环境为沙箱；沙箱生效后响应含"sandbox_mode": true；未接入沙箱网关的接口切换无效；需手动添加X-CodeBuddy-Env: sandbox请求头或使用沙箱签发Token；Mock规则须配置匹配沙箱Header才生效。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在CodeBuddy中调试接口时，若直接连接生产环境或真实后端服务，可能因误操作触发真实订单、扣款、消息推送等不可逆行为，必须通过沙箱隔离测试流量与真实系统。

启用内置沙箱模式

第一步：打开CodeBuddy左侧导航栏，点击【API调试】→进入当前项目下的接口列表。

第二步：在目标接口右侧操作栏，点击「调试」按钮，页面顶部会出现环境选择下拉框，默认为「生产」。

第三步：将环境切换为【沙箱】——此时所有请求自动路由至预置的隔离网关，响应体中的data字段会携带"sandbox_mode": true标识，用于确认生效。

注意：沙箱模式仅对已接入CodeBuddy沙箱网关的接口生效；未配置沙箱路由的接口切换后仍走默认通道，不会报错但不具隔离性。

手动注入沙箱Header

方法一：在请求Headers区域添加键值对：

Key：X-CodeBuddy-Env

Value：sandbox

方法二：若使用Bearer Token认证，需确保Token由沙箱授权中心签发——生产Token在沙箱环境中会被拒绝，返回403且带"reason": "token_not_valid_in_sandbox"提示。

这一步不能省略：沙箱Header必须在发送前设置完成，中途修改Header再重发请求，旧请求仍按原环境执行，【不会回溯修正已发出的请求】。

绑定沙箱Mock规则

进入该接口的「Mock配置」页签 → 点击「新建规则」→ 规则类型选「沙箱专用」→ 在「匹配条件」中填写：headers.X-CodeBuddy-Env === "sandbox"。

然后在响应模板中，可自由定义JSON结构，例如返回模拟支付成功但金额固定为0.01元，或返回特定错误码模拟风控拦截。

关键点：只有当请求同时满足「环境为沙箱」+「命中此Mock规则」两个条件，才会返回Mock数据；否则 fallback 到真实后端（若沙箱网关未拦截）。