Apifox 自动签名调试说明

项目：NDB 三方API，默认模块，main 分支。

已在「默认模块 → 根目录 → 前置操作」保存公共 AK/SK 签名脚本，接口默认继承执行。正式环境前置 URL 已设为 https://crm-api.mindsetech.com。

配置变量

在右上角选择「正式环境」，打开环境管理，在以下变量的本地值填写：

变量	填写内容
ndb_access_key	管理员发放的应用 AK
ndb_secret_key	管理员发放的应用 SK
ndb_idempotency_key	有幂等要求的写操作填写业务唯一键；同一业务重试保留，新业务更换

远程值保持空白，不要同步真实 SK。默认模块也保留了同名空白变量定义，可用于其他环境。当前本地值与远程值均为空，测试用虚构凭证已清除。

选择正式环境，填入 AK/SK 本地值并保存。

打开「internal → 验证应用鉴权 → 调试」，点击发送；有效凭证还需要管理员授予 application:ping。

GET 无需手工填写鉴权头。脚本自动生成秒级时间戳、随机 Nonce、空请求体摘要及 HMAC-SHA256 签名，并写入五个 X-NDB 请求头。

POST 使用 JSON/raw 请求体并填齐接口参数。除了 /clients/resolve/，写接口需提供 ndb_idempotency_key；也可以留空该变量，直接在接口 Header 指定 Idempotency-Key。

接口上手工业务键不能与其他操作共用；在接口上指定时，请先清空环境里的 ndb_idempotency_key，因为环境变量优先。

同一业务重试保持业务键和业务内容不变；每次发送的 HMAC Nonce 和时间戳自动重建。

接口保留「继承父级」前置操作，不要关闭公共脚本。URL 路径参数和 {{variable}} 需先填齐；签名脚本会固定替换后的 URL 和 body，不支持 form-data、urlencoded 或二进制文件请求。签名之后不要另加会更改 URL/body 的前置操作。

导入的 API Key Auth 默认引用 {{apiKey}}。签名脚本会将其设为当前请求临时 AK，避免后续鉴权覆盖 X-NDB-Access-Key；无需手动填写 apiKey，也无需手工填写时间戳、Nonce、摘要或签名。脚本不输出密钥或完整请求体。

Postman Collection SDK 加独立 Node crypto 签名校验：13 项通过，覆盖重复/空查询参数、中文和空格、变量替换、保留 JSON 字节及末尾换行、Nonce 更新、无凭证、无幂等键、错误 body 类型和非 HTTPS 拒绝等。

Apifox 真实运行：空凭证在前置脚本拦截，未发送请求。

Apifox 真实运行：虚构 AK/SK 的只读 ping 已执行，最终实际发送的五个 X-NDB 请求头已核对，HMAC 与独立计算一致。返回 401「应用凭证无效或已停用」符合虚构凭证预期；不代表真实鉴权通过。

未使用真实 AK/SK；未执行报名、约访、取消或结算等业务写操作。虚构本地凭证已清空，远程值未写入凭证。

源码备份：apifox-pre-request.js。

本项目已在根目录配置。接入方在自己的 Apifox 项目使用时，将下列脚本添加到公共根目录前置操作，并配置上述变量本地值。