Postman接口测试全攻略：从入门到精通，看这一篇就够了

GET /api/users?page=2&limit=10 HTTP/1.1 Host: example.com

POST请求：用于创建资源，参数通常放在请求体中

// 请求体示例
{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "123456"
}

PUT请求：用于更新完整资源

// 请求体示例
{
  "id": 123,
  "name": "John Doe",
  "email": "john@example.com",
  "password": "654321"
}

// 只更新email字段
{
  "email": "new_email@example.com"
}

DELETE /api/users/123 HTTP/1.1
Host: example.com

https://api.example.com/products?category=books&sort=price&order=desc

GET /api/users/{userId}/posts/{postId}

https://api.example.com/users/123/posts/456

Authorization: Bearer xxxxxxxx
Content-Type: application/json
Accept: application/json

base_url: https://api.dev.example.com
api_key: abcdef123456

{{base_url}}/users?api_key={{api_key}}

// 检查状态码是否为200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});
// 检查响应体中包含特定字段
pm.test("Response has user data", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('user');
    pm.expect(jsonData.user).to.have.property('name');
    pm.expect(jsonData.user.name).to.be.a('string');
});
// 检查响应时间在合理范围内
pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

// 1. 基本状态和结构验证
pm.test("Basic validation", function () {
    // 验证状态码
    pm.response.to.have.status(200);

    // 验证Content-Type头
    pm.response.to.have.header("Content-Type", "application/json; charset=utf-8");

    // 验证JSON结构
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.be.an('object');
    pm.expect(jsonData).to.have.property('success', true);
});
// 2. 数据完整性检查
pm.test("Data integrity check", function () {
    var jsonData = pm.response.json();

    // 检查必需字段存在
    const requiredFields = ['id', 'name', 'email', 'createdAt'];
    requiredFields.forEach(field => {
        pm.expect(jsonData.user).to.have.property(field);
    });

    // 检查数据类型
    pm.expect(jsonData.user.id).to.be.a('number');
    pm.expect(jsonData.user.name).to.be.a('string');
    pm.expect(jsonData.user.email).to.include('@');
    pm.expect(new Date(jsonData.user.createdAt)).to.be.a('Date');
});
// 3. 业务逻辑验证
pm.test("Business logic validation", function () {
    var jsonData = pm.response.json();

    // 验证用户状态
    pm.expect(jsonData.user.isActive).to.be.true;

    // 验证权限等级
    pm.expect(jsonData.user.role).to.be.oneOf(['user', 'admin', 'moderator']);

    // 验证数据一致性
    if (jsonData.user.profile) {
        pm.expect(jsonData.user.profile.userId).to.equal(jsonData.user.id);
    }
});

// 从登录响应中提取token并保存到环境变量
pm.test("Extract and save token", function () {
    var jsonData = pm.response.json();

    // 检查token是否存在
    pm.expect(jsonData).to.have.property('token');

    // 将token保存到环境变量
    pm.environment.set("auth_token", jsonData.token);

    // 也可以设置过期时间（例如30分钟后过期）
    const expires = new Date();
    expires.setMinutes(expires.getMinutes() + 30);
    pm.environment.set("token_expires", expires.toISOString());
});
// 在后续请求的Headers中使用保存的token
// 在请求的Headers中添加：Authorization: Bearer {{auth_token}}

// 使用JSON Schema验证响应结构
pm.test("Response matches JSON Schema", function () {
    var schema = {
        type: "object",
        properties: {
            success: { type: "boolean" },
            data: {
                type: "object",
                properties: {
                    id: { type: "number" },
                    name: { type: "string" },
                    email: { type: "string", format: "email" },
                    roles: {
                        type: "array",
                        items: { type: "string" }
                    }
                },
                required: ["id", "name", "email"]
            },
            message: { type: "string" }
        },
        required: ["success", "data"]
    };

    pm.response.to.have.jsonSchema(schema);
});
// 验证数组内容
pm.test("Array validation", function () {
    var jsonData = pm.response.json();

    pm.expect(jsonData.items).to.be.an('array');
    pm.expect(jsonData.items).to.have.length.above(0);

    // 验证数组中的每个元素都满足条件
    jsonData.items.forEach(item => {
        pm.expect(item).to.have.property('id');
        pm.expect(item.id).to.be.a('number');
        pm.expect(item).to.have.property('name');
        pm.expect(item.name).to.be.a('string').that.is.not.empty;
    });
});
// 使用外部数据文件进行数据驱动测试
// 首先在Collection Runner中上传CSV或JSON文件
// 然后在脚本中引用数据变量
pm.test("Validate with external data", function () {
    const testData = pm.iterationData.get("expected_value");
    pm.expect(pm.response.json().value).to.equal(testData);
});

username,password,expected_status
admin,admin123,200
user1,password1,200
invalid_user,wrong_pass,401

// 读取数据文件中的值
var username = pm.iterationData.get("username");
var password = pm.iterationData.get("password");
var expectedStatus = pm.iterationData.get("expected_status");
// 使用数据值进行测试
pm.test(`Status should be ${expectedStatus} for ${username}`, function () {
    pm.response.to.have.status(parseInt(expectedStatus));
});

// 根据条件跳转到指定请求
if (pm.response.code === 401) {
    // 如果认证失败，跳转到登录请求
    postman.setNextRequest("Login");
} else {
    // 正常执行下一个请求
    postman.setNextRequest(null);
}
// 跳过某些请求
if (pm.environment.get("skip_cleanup") === "true") {
    postman.setNextRequest("Final Report");
}

{
  "id": {{$randomInt}},
  "name": "{{$randomFirstName}}",
  "email": "{{$randomEmail}}",
  "createdAt": "{{$timestamp}}",
  "status": "{{$randomBoolean}}"
}

# 安装Newman
npm install -g newman
# 运行集合
newman run mycollection.json -e env.json -r html,json
# 使用数据文件
newman run mycollection.json -d data.csv -r cli
# 生成多种格式的报告
newman run mycollection.json -r html,json,junit

pipeline {
    agent any
    stages {
        stage('API Test') {
            steps {
                script {
                    // 安装Newman
                    sh 'npm install -g newman'

                    // 运行测试
                    sh 'newman run collection.json -e environment.json --reporters cli,html --reporter-html-export report.html'

                    // 发布测试报告
                    publishHTML target: [
                        allowMissing: false,
                        alwaysLinkToLastBuild: false,
                        keepAll: true,
                        reportDir: '.',
                        reportFiles: 'report.html',
                        reportName: 'API Test Report'
                    ]
                }
            }
        }
    }
}

// 减少不必要的测试
// 只在需要时运行耗时测试
if (pm.environment.get("run_performance_tests") === "true") {
    pm.test("Performance test", function () {
        pm.expect(pm.response.responseTime).to.be.below(100);
    });
}
// 使用缓存避免重复请求
const cachedResponse = pm.environment.get("cached_data");
if (!cachedResponse) {
    // 第一次请求，缓存数据
    pm.environment.set("cached_data", pm.response.json());
}
// 批量处理请求
// 使用集合运行器代替手动逐个请求

console.log("Response time: ", pm.response.responseTime);
console.log("Environment: ", pm.environment.toObject());