Расскажи про свой опыт работы с проблемами на текущем проекте

Postman Collections: мой опыт

Postman collections — это powerful инструмент для BA при работе с API требованиями. Это не просто инструмент для тестирования, это может быть documentation и validation tool.

Как я использовал Postman collections

1. Как executable documentation

Вместо только описания API в document, я создавал Postman collection где:

• Каждый request имеет пример
• Каждый response документирован
• Можно click и видеть real request/response

Примеры:

Collection: Payment API
  GET /payments/{id}
    - Pre-request script: set payment_id variable
    - Request body: (empty for GET)
    - Response: 200 OK example
    
  POST /payments
    - Request body: example JSON
    - Response: 201 Created example with id
    
  POST /payments/{id}/refund
    - Request body: refund amount
    - Response: 200 OK с new status

2. Как validation tool

Я писал tests в Postman что validate requirements:

// Test: Response status is 200
pm.test("Status is 200", function() {
    pm.response.to.have.status(200);
});

// Test: Response has required fields
pm.test("Response has id field", function() {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('id');
    pm.expect(jsonData).to.have.property('status');
});

// Test: Payment amount is correct
pm.test("Amount is correct", function() {
    var jsonData = pm.response.json();
    pm.expect(jsonData.amount).to.equal(100.00);
});

Девелопер может run эти tests, если они fail - он знает что requirement не implemented.

3. Как shared documentation

Я share Postman collection с team через:

• Export JSON
• Import в их Postman
• Или share Postman workspace

Теперь все имеют same API examples.

Конкретный пример (Marketplace API)

Scenario: Спроектировать API для freelancer чтобы найти projects.

Что я сделал в Postman:

1. Created folder structure:

Marketplace API
  └ Projects
    ├ List projects
    ├ Get project details
    ├ Submit proposal
    └ Get my proposals
  └ Freelancer
    ├ Get profile
    └ Update profile

1. For each request, я добавил:

Request: GET /api/v1/projects?category=web&status=open

Params:
- category: "web"
- min_budget: 500
- max_budget: 5000

Headers:
- Authorization: Bearer token
- Content-Type: application/json

Response (200):
[
  {
    "id": "proj_123",
    "title": "Build landing page",
    "description": "Need modern landing page",
    "budget": 2000,
    "status": "open",
    "proposals_count": 5,
    "created_at": "2024-03-20T10:00:00Z"
  }
]

Test:
response.status == 200
response.body has id
response.body has title

1. Added environment variables:

Base URL: {{baseUrl}}
Auth token: {{token}}
User ID: {{user_id}}

Так разные environments (dev, staging, production) работают same collection.

Как это помогло проекту

Problem: Разработчик не понимал что точно нужно. Solution: Я shared Postman collection. Разработчик opened collection, видел examples, сразу понял.

Problem: QA не знала что тестировать. Solution: Tests в Postman collection дали ей exact criteria.

Problem: API документация была outdated. Solution: Postman collection всегда актуальна потому что люди testing her.

Advanced features которые я использовал

1. Pre-request scripts:

// Generate idempotency_key перед каждым request
pm.variables.set("idempotency_key", pm.utils.generateUUID());

// Set timestamp
pm.variables.set("request_timestamp", new Date().toISOString());

2. Post-request scripts:

// Save payment_id для следующего request
var jsonData = pm.response.json();
pm.variables.set("payment_id", jsonData.id);

3. Collection runner:

• Run entire API flow (create → validate → update → delete)
• Automated testing
• Generate report

4. Newman (CLI):

newman run collection.json -e environment.json

Eтого можно добавить в CI/CD pipeline.

Примеры когда Postman collection спасал

Пример 1: API versioning

Мы launched v2 API but старый v1 still работает.

Я создал две collections: API v1 и API v2. Это показало что changed:

v1: POST /payments (returns charge_id)
v2: POST /payments (returns transaction_id)

Девелопер видел difference, не забыл update код.

Пример 2: Error scenarios

Я создал folder "Error cases" в collection:

- 401 Unauthorized
- 429 Rate limit
- 500 Server error
- 400 Bad request

Каждый имеет example response что показывает developers как handle errors.

Пример 3: Performance testing

Разработчик спросил: "Как часто мы call payment API?" Я в Postman:

- Collection runner
- Run 100 requests
- Measure average response time
- If > 3 seconds: we have problem

Проблему обнаружили рано.

Best practices для Postman collections

1. Organize логически

• By resource (users, payments, projects)
• Not by HTTP method

2. Add documentation

• Description для каждого request
• Why это требование
• Example use cases

3. Use переменные

• {{baseUrl}}
• {{auth_token}}
• {{resource_id}}

Так collection работает в разных environments.

4. Add tests

• Status code
• Response structure
• Required fields

5. Keep актуальной

• When requirement changes, update collection
• Version это: v1.0, v1.1, v2.0

6. Share с team

• Export JSON
• Put в git repository
• Share Postman workspace

Когда я это использовал в production

Марketplace проект где freelancers submit proposals. API:

POST /projects/{id}/proposals
Body: {
  "bid_amount": 1500,
  "cover_letter": "I can do this",
  "estimated_days": 7,
  "portfolio_url": "myportfolio.com"
}

Response: {
  "id": "proposal_123",
  "status": "pending",
  "created_at": "2024-03-26T10:00:00Z"
}

Я в Postman:

1. Created example request (как выше)
2. Added tests (status 201, has proposal id)
3. Added Pre-request script (generate unique cover_letter)
4. Shared с freelancer frontend team

Результат: backend и frontend быстро согласовали API contract.

Вывод

Postman collections это не просто инструмент для testing. Для BA это:

• Executable documentation
• Validation tool
• Team communication
• CI/CD integration

Хорошая Postman collection:

• Экономит время разработчикам
• Дает QA clear test criteria
• Serve как documentation
• Prevent miscommunications

Best projects которые я делал имели well-maintained Postman collections.