OpenAPI/Swagger Specification Template

Create OpenAPI specification for:

API Name: {{API_NAME}}
API Version: {{VERSION}}
Base URL: {{BASE_URL}}
Authentication: {{AUTH_TYPE}}

Generate complete OpenAPI document:

1. **Info Section:**
   - Title and description
   - Version
   - Contact information
   - License
   - Terms of service

2. **Servers:**
   - Production server
   - Staging server
   - Development server
   - Server variables

3. **Security Schemes:**
   - API key authentication
   - OAuth2 flows
   - JWT bearer
   - Basic auth

4. **Paths/Endpoints:**
   - GET/POST/PUT/PATCH/DELETE
   - Path parameters
   - Query parameters
   - Request bodies
   - Responses (200, 400, 401, 404, 500)

5. **Components/Schemas:**
   - Data models
   - Request schemas
   - Response schemas
   - Enum definitions
   - Composition (allOf, oneOf, anyOf)

6. **Common Patterns:**
   - Pagination schema
   - Error response schema
   - List response wrapper
   - Audit fields

7. **Examples:**
   - Request examples
   - Response examples
   - Multiple examples per operation

8. **Tags:**
   - Tag definitions
   - Tag descriptions
   - Endpoint grouping

9. **Documentation:**
   - Markdown descriptions
   - External docs links
   - Operation descriptions

Include code generation configuration hints.