Postman: полное руководство по использованию инструмента для API тестирования 2025

Настройка GET запроса

1. Выберите метод GET
2. Введите URL
3. Добавьте параметры (если нужно)
4. Нажмите Send

Пример с параметрами:

GET https://jsonplaceholder.typicode.com/posts
?userId=1&_limit=5

Этот запрос получит первые 5 постов пользователя с ID 1.

Создание POST запроса

1. Выберите метод POST
2. Введите URL
3. Перейдите на вкладку Body
4. Выберите raw и JSON
5. Введите данные в формате JSON

Пример создания нового поста:

URL: https://jsonplaceholder.typicode.com/posts

{
  "title": "Мой новый пост",
  "body": "Содержимое поста",
  "userId": 1
}

Удаление ресурса

URL: DELETE https://jsonplaceholder.typicode.com/posts/1

Этот запрос удалит пост с ID 1.

Ожидаемый ответ: Статус 200 OK или 204 No Content

Как создать коллекцию:

1. Нажмите "New" → "Collection"
2. Дайте название коллекции
3. Добавьте описание (опционально)
4. Нажмите "Create"

Пример названий коллекций:

• 📱 "User Management API"
• 🛒 "E-commerce API Tests"
• 📧 "Email Service Integration"
• 🔐 "Authentication Tests"

Полезные настройки коллекции:

1. Pre-request Scripts (скрипты до запроса)

Выполняются перед каждым запросом в коллекции:

// Установка базового URL
pm.environment.set("baseUrl", "https://api.example.com");

// Генерация случайного email
pm.environment.set("randomEmail", `test${Date.now()}@example.com`);

2. Tests (тесты коллекции)

Выполняются после каждого запроса:

// Проверка статуса ответа
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

// Проверка времени ответа
pm.test("Response time is less than 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

Как создать окружение:

1. Нажмите "New" → "Environment"
2. Дайте название: "Development"
3. Добавьте переменные:

Пример переменных для Development:

Синтаксис переменных:

В Postman переменные используются в фигурных скобках: {{variableName}}

Примеры использования:

• URL: {{baseUrl}}/users/{{userId}}
• Header: Authorization: Bearer {{apiKey}}
• Body: {"userId": {{userId}}, "name": "Test"}

Реальный пример запроса:

GET {{baseUrl}}/users/{{userId}}
Authorization: Bearer {{apiKey}}
Content-Type: application/json

При выборе окружения "Development" это превратится в:

GET https://dev-api.example.com/users/1
Authorization: Bearer dev-key-123
Content-Type: application/json

Структура тестов в Postman

Тесты пишутся на JavaScript в разделе "Tests" каждого запроса:

Базовые тесты:

// Проверка статус кода
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

// Проверка времени ответа
pm.test("Response time is less than 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

// Проверка заголовка
pm.test("Content-Type is application/json", function () {
    pm.expect(pm.response.headers.get("Content-Type")).to.include("application/json");
});

Проверка структуры JSON

Допустим, API возвращает такой ответ:

{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "address": {
    "city": "New York",
    "country": "USA"
  }
}

Тесты для этого ответа:

// Проверка наличия полей
pm.test("Response has required fields", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('id');
    pm.expect(jsonData).to.have.property('name');
    pm.expect(jsonData).to.have.property('email');
});

// Проверка типов данных
pm.test("Field types are correct", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData.id).to.be.a('number');
    pm.expect(jsonData.name).to.be.a('string');
    pm.expect(jsonData.email).to.be.a('string');
});

// Проверка значений
pm.test("Email format is valid", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData.email).to.match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
});

// Проверка вложенных объектов
pm.test("Address object is present", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('address');
    pm.expect(jsonData.address).to.have.property('city');
    pm.expect(jsonData.address).to.have.property('country');
});

1. Проверка массивов

pm.test("Response is an array", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.be.an('array');
});

pm.test("Array has at least 1 item", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.have.length.above(0);
});

pm.test("All items have required fields", function () {
    const jsonData = pm.response.json();
    jsonData.forEach(item => {
        pm.expect(item).to.have.property('id');
        pm.expect(item).to.have.property('name');
    });
});

2. Проверка ошибок

pm.test("Error response structure", function () {
    pm.response.to.have.status(400);
    
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('error');
    pm.expect(jsonData).to.have.property('message');
});

3. Проверка производительности

pm.test("Response time is acceptable", function () {
    pm.expect(pm.response.responseTime).to.be.below(1000);
});

pm.test("Response size is reasonable", function () {
    pm.expect(pm.response.responseSize).to.be.below(10000);
});

Что такое Pre-request Scripts?

Это JavaScript код, который выполняется перед отправкой запроса. Очень полезно для:

• Генерации динамических данных
• Получения токенов авторизации
• Настройки переменных
• Подготовки тестовых данных

Примеры использования:

// Генерация случайного email
pm.environment.set("randomEmail", `test${Date.now()}@example.com`);

// Генерация UUID
pm.environment.set("requestId", pm.variables.replaceIn('{{$randomUUID}}'));

// Установка текущего времени
pm.environment.set("timestamp", new Date().toISOString());

// Генерация случайного пароля
pm.environment.set("password", Math.random().toString(36).slice(-8));

Что такое Newman?

Newman — это командная версия Postman. Позволяет запускать коллекции из командной строки, что идеально для CI/CD.

Установка Newman:

npm install -g newman

Экспорт коллекции:

Сначала экспортируйте коллекцию из Postman в JSON файл.

Запуск коллекции:

# Базовый запуск
newman run collection.json

# С окружением
newman run collection.json -e environment.json

# С HTML отчетом
newman run collection.json -r html --reporter-html-export report.html

# С JSON отчетом
newman run collection.json -r json --reporter-json-export report.json

Интеграция с Jenkins:

pipeline {
    agent any
    stages {
        stage('API Tests') {
            steps {
                sh 'newman run api-tests.json -e prod-env.json'
            }
        }
    }
}

🎯 Правильная структура коллекций

MyApp API Tests/
├── 📁 Authentication/
│   ├── Login
│   ├── Logout
│   ├── Refresh Token
│   └── Register
├── 📁 User Management/
│   ├── Create User
│   ├── Get User
│   ├── Update User
│   ├── Delete User
│   └── List Users
├── 📁 Orders/
│   ├── Create Order
│   ├── Get Order
│   ├── Update Order Status
│   └── Cancel Order
└── 📁 Reports/
    ├── Daily Sales
    ├── Monthly Revenue
    └── User Statistics

Принципы именования:

• Используйте понятные названия
• Добавляйте эмодзи для визуального разделения
• Группируйте по функциональности
• Следуйте REST принципам

🎯 Совместная разработка

1. Версионирование

Используйте Git для версионирования коллекций и окружений

2. Code Review

Проводите ревью изменений в коллекциях

3. Документация

Добавляйте описания к запросам и переменным

4. Стандарты

Создайте стандарты именования и структуры

5. Обучение

Обучайте новых членов команды работе с Postman

❌ Проблема: "Could not get any response"

Причины:

• Неправильный URL
• Сервер недоступен
• Проблемы с интернет-соединением
• Блокировка файрволлом

Решения:

1. Проверьте URL в браузере
2. Проверьте интернет-соединение
3. Отключите VPN/прокси
4. Проверьте настройки файрвола

❌ Проблема: "401 Unauthorized"

Причины:

• Отсутствует токен авторизации
• Истек срок действия токена
• Неправильный формат токена

Решения:

1. Проверьте заголовок Authorization
2. Обновите токен авторизации
3. Проверьте формат: "Bearer YOUR_TOKEN"
4. Убедитесь, что токен не истек

❌ Проблема: "404 Not Found"

Причины:

• Неправильный endpoint
• Ресурс не существует
• Неправильный HTTP метод

Решения:

1. Проверьте документацию API
2. Убедитесь в правильности URL
3. Проверьте HTTP метод (GET, POST, etc.)
4. Проверьте, что ресурс существует

🔍 Инструменты отладки

1. Console (консоль)

Используйте console.log() для вывода отладочной информации:

console.log("Response status:", pm.response.status);
console.log("Response body:", pm.response.json());
console.log("Environment variables:", pm.environment.toObject());

2. Network (сеть)

Проверяйте детали запросов во вкладке Network

3. Postman Console

Откройте View → Show Postman Console для просмотра логов

4. Test Results

Анализируйте результаты тестов для выявления проблем