LOCAL DEVELOPMENT

本地开发与联调预检

本机 Sandbox 用 HTTP 即可，不需要自签名证书。开放平台地址和应用自身地址是独立配置；不要因为应用使用 HTTPS，就把平台 HTTP 地址自动改为 HTTPS。

平台

http://localhost:3000应用服务端请求的平台 Origin，不带 /v1；凭据必须来自这套平台数据库。

应用

http://localhost:5173示例应用 Origin / APP_URL。交接地址为 /oauth/dsfulfill/install，启动地址为 /install/launch，均须匹配实际监听协议与端口。

边界

仅本机 Sandbox 允许 HTTPlocalhost、127.0.0.1、[::1] 是本机地址；Production 与远程地址使用 HTTPS。修改环境变量后重启服务并核对实际生效值。

先检查连接，再使用授权码

在实际服务端运行时执行无凭据、无写入

const response = await fetch(platformOrigin + "/v1/health", {
  signal: AbortSignal.timeout(5000),
});
const body = await response.json();
// 预期 HTTP 200 且 body.data.status === "ok"
// 健康检查不代表凭据或安装权限验证通过。

curl 成功，应用 fetch 仍失败

检查实际运行时网络

检查开发进程的代理、DNS、IPv4/IPv6 与监听地址。特定开发工具导入后可能接管全局代理，导致 localhost 请求未遵循 NO_PROXY。仅调整开发子进程代理，不修改系统或生产代理，不关闭 TLS 校验，也不要用真实交接码反复测试网络。

健康检查通过后再发起一笔全新的 ERP 授权。不要刷新旧确认页、复用旧 authorization_id 或反复提交同一个一次性交接码。