Hoppscotch中API Key认证失败需检查配置方式：一、Headers中设x-api-key头；二、Authorization页选API Key类型并指定Key名、Place位置；三、Pre-request Script脚本动态注入环境变量密钥。

如果您在Hoppscotch中调用需要API Key认证的接口，但请求始终返回401未授权错误，则很可能是API Key未被正确注入或格式不匹配。以下是配置API Key认证方式的具体步骤：

一、通过Headers方式配置API Key

该方式将API Key作为HTTP请求头发送，符合多数服务端对x-api-key标准头的校验逻辑，避免URL参数解析异常或大小写敏感问题。

1、在Hoppscotch请求编辑区域，点击顶部标签栏中的Headers选项卡。

2、在Key输入框中键入x-api-key（注意连字符和全小写）。

3、在Value输入框中粘贴您的有效API密钥值。

4、确保URL中已移除所有类似?apiKey=xxx的查询参数，防止头与参数冲突。

5、点击Send按钮发起请求，检查响应状态码是否变为200。

二、通过Authorization标签页配置API Key

该方式利用Hoppscotch内置的API Key认证类型，自动处理参数名、位置及编码逻辑，适用于必须使用查询参数或Cookie传递密钥的后端服务。

1、切换到请求编辑区域顶部的Authorization标签页。

2、在Type下拉菜单中选择API Key。

3、在Key字段中输入服务器实际期望的参数名称，例如api_key（非apiKey）、key或token。

4、在Value字段中填入您的API密钥字符串。

5、在Place下拉菜单中选择密钥注入位置：Query（添加至URL末尾）、Header（等效于方法一）或Cookie（需确认服务端支持）。

6、保存设置后发送请求，观察“Test Results”中实际发出的URL或请求头是否包含预期密钥信息。

三、通过预请求脚本动态注入API Key

该方式适用于密钥需从环境变量读取、经计算生成或受时效控制的场景，可绕过界面配置限制，实现完全自定义注入逻辑。

1、切换到请求编辑区域顶部的Pre-request Script标签页。

2、输入以下JavaScript代码：

pm.request.url.query.add("api_key", pm.environment.get("MY_API_KEY"));

3、确保已在环境管理中创建名为MY_API_KEY的加密环境变量，并填入有效密钥值。

4、若需注入Header，改用以下语句：

pm.request.headers.add({ key: "x-api-key", value: pm.environment.get("MY_API_KEY") });

5、点击Send前确认脚本无语法错误，运行时控制台不报错。