Initial commit: Playwright API Test Framework with Cucumber/BDD

- 76 Gherkin scenarios (409 steps) covering comprehensive API testing
- Advanced patterns: HTTP protocol, identity, sorting, pagination, idempotency, performance, data quality
- Contract validation for external API testing
- Authentication examples (Bearer, API Key, Basic Auth)
- Complete documentation with guides
- CI/CD workflow with GitHub Actions
- MIT License

Author: Thor011

.env.example

@@ -0,0 +1,18 @@
+# API Test Environment Variables
+# Copy this file to .env and fill in your actual values
+
+# API Configuration
+API_BASE_URL=https://jsonplaceholder.typicode.com
+
+# Authentication
+API_BEARER_TOKEN=your-bearer-token-here
+API_KEY=your-api-key-here
+
+# OAuth (if needed)
+OAUTH_CLIENT_ID=your-client-id
+OAUTH_CLIENT_SECRET=your-client-secret
+OAUTH_TOKEN_URL=https://oauth.example.com/token
+
+# Test Configuration
+TEST_TIMEOUT=30000
+PARALLEL_WORKERS=4

.github/copilot-instructions.md

@@ -0,0 +1,35 @@
+# API Test Framework - Project Instructions
+
+## Project Overview
+Playwright API test framework with TypeScript for comprehensive REST API testing.
+
+## Technology Stack
+- **Framework**: Playwright (API testing)
+- **Language**: TypeScript
+- **Test Runner**: Playwright Test
+- **Reporters**: HTML, JSON
+
+## Project Structure
+- `/tests` - API test files
+- `/tests/helpers` - Helper functions and utilities
+- `/tests/config` - Configuration files
+- `playwright.config.ts` - Playwright configuration
+
+## Development Guidelines
+- Write tests using async/await pattern
+- Use Playwright's APIRequestContext for HTTP calls
+- Organize tests by API endpoint or feature
+- Include authentication examples
+- Validate response status, headers, and body
+
+## Test Execution
+- Run all tests: `npx playwright test`
+- Run specific test: `npx playwright test <filename>`
+- Run with UI: `npx playwright test --ui`
+- Generate report: `npx playwright show-report`
+
+## Coding Standards
+- Use TypeScript strict mode
+- Follow async/await best practices
+- Add meaningful test descriptions
+- Include assertions for status codes and data

.github/workflows/api-tests.yml

@@ -0,0 +1,48 @@
+name: API Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+      
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Install Playwright browsers
+      run: npx playwright install chromium
+      
+    - name: Run API tests
+      run: npm test
+      
+    - name: Upload test results
+      uses: actions/upload-artifact@v3
+      if: always()
+      with:
+        name: playwright-report
+        path: playwright-report/
+        retention-days: 7
+        
+    - name: Upload test results JSON
+      uses: actions/upload-artifact@v3
+      if: always()
+      with:
+        name: test-results
+        path: test-results/
+        retention-days: 7

.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: API Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Install Playwright browsers
+      run: npx playwright install --with-deps
+    
+    - name: Run Playwright tests
+      run: npm test
+    
+    - name: Run Cucumber tests
+      run: npm run test:cucumber
+    
+    - name: Upload Playwright report
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: playwright-report-${{ matrix.node-version }}
+        path: playwright-report/
+        retention-days: 30
+    
+    - name: Upload Cucumber report
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: cucumber-report-${{ matrix.node-version }}
+        path: cucumber-report.html
+        retention-days: 30

.gitignore

@@ -0,0 +1,38 @@
+# Dependencies
+node_modules/
+
+# Test results
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+
+# Cucumber reports
+cucumber-report.html
+cucumber-report.json
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Build output
+dist/
+build/

.nvmrc

@@ -0,0 +1 @@
+20.11.0