Api Testing 1

---
name: API Testing
description: Automated API testing, mocking, and documentation
---

# API Testing Skill

## Tools Required
- `httpie` (brew) - HTTP client
- `jq` (brew) - JSON processing
- `curl` - HTTP requests

## Endpoints Testing

### Quick API Test
```bash
# GET request
http GET https://api.example.com/endpoint

# POST with JSON
http POST https://api.example.com/endpoint name="value"

# With auth header
http GET https://api.example.com/endpoint Authorization:"Bearer TOKEN"
```

### Supabase API Testing
```bash
# Test Supabase connection
curl -X GET "https://YOUR_PROJECT.supabase.co/rest/v1/TABLE" \
  -H "apikey: YOUR_ANON_KEY" \
  -H "Authorization: Bearer YOUR_ANON_KEY"
```

## Mock Server
```bash
# Quick mock server with json-server
npx json-server --watch db.json --port 3001
```

## Load Testing
```bash
# Using hey (install: brew install hey)
hey -n 1000 -c 50 https://api.example.com/endpoint

# Apache benchmark
ab -n 1000 -c 50 https://api.example.com/endpoint
```

## API Documentation
```bash
# Generate OpenAPI spec from Express
npx swagger-jsdoc -d swaggerDef.js -o swagger.json

# Serve Swagger UI
npx swagger-ui-express swagger.json
```

## Response Validation
```javascript
// Validate JSON schema
const Ajv = require('ajv');
const ajv = new Ajv();
const validate = ajv.compile(schema);
const valid = validate(data);
```

## Common Patterns

### Health Check Endpoint
```javascript
app.get('/health', (req, res) => {
  res.json({
    status: 'healthy',
    timestamp: new Date().toISOString(),
    version: process.env.npm_package_version
  });
});
```

### Rate Limit Testing
```bash
# Rapid-fire requests to test rate limiting
for i in {1..100}; do
  curl -s -o /dev/null -w "%{http_code}\n" https://api.example.com/endpoint
done
```