Apifox实战指南：如何高效测试带Token的API接口

1次阅读

没有评论

共计 2329 个字符，预计需要花费 6 分钟才能阅读完成。

在 API 开发中，Token 认证是最常见的安全机制之一。但带 Token 的 API 测试往往比普通接口更复杂，主要体现在以下几个方面：

Token 通常有过期时间，需要定期刷新
需要在每个请求中手动添加 Token 头信息
测试不同权限的接口时需要切换不同 Token
Token 失效时难以快速定位问题

这些痛点导致测试效率低下，特别是对于新手开发者来说，容易在 Token 处理上浪费大量时间。

Apifox 是一款强大的 API 协作平台，针对带 Token 的 API 测试提供了完整的解决方案：

支持多种 Token 类型（Bearer、Basic Auth 等）
提供环境变量管理 Token
自动在请求中添加 Token 头
支持 Token 自动刷新
可视化 Token 管理界面

大多数 API 系统都会提供获取 Token 的接口，通常是一个 POST 请求。例如：

POST /api/auth/login
Content-Type: application/json

{
  "username": "your_username",
  "password": "your_password"
}

在 Apifox 中，我们可以将获取到的 Token 保存为环境变量：

在 Apifox 中创建或选择一个环境
在 ” 环境变量 ” 部分添加一个变量，比如命名为 ”ACCESS_TOKEN”
在获取 Token 的接口测试中，使用 ”Tests” 脚本将响应中的 Token 保存到环境变量

// 在获取 Token 接口的 Tests 标签页中添加
const jsonData = pm.response.json();
pm.environment.set("ACCESS_TOKEN", jsonData.access_token);

在需要 Token 的接口中，我们可以通过以下方式自动添加 Token：

在请求的 ”Headers” 中添加 Authorization 头
值设置为 Bearer {{ACCESS_TOKEN}}（根据你的 Token 类型调整）
Apifox 会自动用环境变量中的值替换 {{ACCESS_TOKEN}}

下面是一个完整的 API 测试用例，包含 Token 处理逻辑：

// 获取 Token
pm.sendRequest({
  url: 'https://api.example.com/auth/login',
  method: 'POST',
  header: {'Content-Type': 'application/json'},
  body: {
    mode: 'raw',
    raw: JSON.stringify({username: 'test', password: 'test123'})
  }
}, function (err, res) {const jsonData = res.json();
  pm.environment.set("ACCESS_TOKEN", jsonData.access_token);

  // 使用 Token 测试其他接口
  pm.sendRequest({
    url: 'https://api.example.com/user/profile',
    method: 'GET',
    header: {'Authorization': 'Bearer {{ACCESS_TOKEN}}'
    }
  }, function (err, res) {console.log(res.json());
  });
});

在实际使用中，新手常遇到以下问题：

Token 过期问题
解决方案：设置定期刷新 Token 的逻辑，或者延长 Token 有效期
环境变量未生效
检查是否选择了正确的环境
确保变量名拼写正确（区分大小写）
Token 格式错误
确认 Token 类型（Bearer、Basic 等）
检查 Token 是否包含多余的空格或换行符
权限不足
确认 Token 是否具有访问目标接口的权限
可能需要使用不同权限级别的 Token

我们可以设置预请求脚本，在 Token 即将过期时自动刷新：

// 在集合的 Pre-request Script 中添加
const tokenExpiry = pm.environment.get("TOKEN_EXPIRY");
const now = new Date().getTime();

if (!tokenExpiry || now > tokenExpiry) {
  pm.sendRequest({
    url: 'https://api.example.com/auth/refresh',
    method: 'POST',
    header: {'Authorization': 'Bearer {{ACCESS_TOKEN}}'
    }
  }, function (err, res) {const jsonData = res.json();
    pm.environment.set("ACCESS_TOKEN", jsonData.access_token);
    pm.environment.set("TOKEN_EXPIRY", now + jsonData.expires_in * 1000);
  });
}

Apifox 支持测试套件，可以创建包含多个接口的自动化测试流程：