应使用环境变量和变量引用替代硬编码API密钥:在Headers中设X-API-Key: {{api_key}},值由环境变量api_key提供;避免预请求脚本冗余操作;注意Authorization头的命名与格式规范。

Postman 里把 API Key 放进请求头,不是“加个 Header 就完事”,关键在于怎么放得安全、可维护、不硬编码。
直接在 Headers 标签里填 X-API-Key 是最常见但最危险的做法
很多人打开 Headers 选项卡,手敲 X-API-Key 和值,比如 abc123def456。这会导致:
- 敏感密钥明文暴露在集合文件中,一导出就泄露
- 换环境(dev/staging/prod)必须手动改每个请求,极易漏改或填错
- 团队协作时,别人直接看到你的生产密钥
正确做法是:用环境变量解耦密钥值,用变量引用代替硬编码。
用 pm.environment.get() 动态注入 Header 值
Header 里不写死密钥,而是写 {{api_key}} 这类变量占位符;实际值由当前激活的环境提供。操作步骤:
- 点击右上角环境切换器 → “Manage Environments” → 新建环境(如
dev) - 在该环境中添加变量:
api_key,值设为真实密钥(如sk_test_789xyz) - 回到请求的 Headers 标签,Key 填
X-API-Key,Value 填{{api_key}} - 确保右上角环境已选中
dev,再发请求
这样切换环境只需点一下,所有用到 {{api_key}} 的请求自动生效,无需改任何 Header 行。
预请求脚本里动态生成 Header 更灵活,但容易多此一举
有人喜欢用 Pre-request Script 手动塞 Header,比如:
Postman Mac版是一款专为macOS设计的API开发与测试工具,凭借简洁的界面和强大的功能,深受开发者喜爱。它支持发送各种HTTP请求(GET、POST、PUT等),轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验,适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作,Postman for Mac都能提升API开发效率,是ma
pm.request.headers.add({
key: 'X-API-Key',
value: pm.environment.get('api_key')
});
这其实没必要——Headers 标签本身支持变量替换,且更直观、易调试。只有当你需要:
- 根据时间戳/随机数拼接密钥(如
X-API-Key: {{api_key}}-{{timestamp}}) - 从另一个变量计算出密钥(如 base64 编码后再用)
- 条件性添加 Header(比如只在
pm.environment.name === 'prod'时才加)
才值得动用脚本。否则纯属增加维护成本和出错概率。
别忽略 Authorization 头的命名规范
有些 API 要求 Key 放在 Authorization 头里,格式不是 X-API-Key,而是:
-
Bearer {{token}}(OAuth2 场景) -
Apikey {{api_key}}(注意大小写和空格,有些服务严格校验) -
Token token={{api_key}}(旧式 Token 认证)
务必查清文档——填错 Key 名或格式,返回 401 Unauthorized 时你可能还在检查密钥对不对,而问题出在头名拼错了。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










