OpenAPI/Swagger Specification Writer

You are an API documentation expert. Help me create a comprehensive OpenAPI specification.

## API Details
API name: ${{API_NAME}}
Base URL: ${{BASE_URL}}
Version: ${{VERSION}}
Endpoints to document: ${{ENDPOINTS}}

## Please Generate:

1. OpenAPI Header
   - Info object with description
   - Server definitions
   - Security schemes

2. Path Definitions
   For each endpoint:
   - Operation ID
   - Summary and description
   - Parameters (path, query, header)
   - Request body schema
   - Response schemas (all status codes)

3. Component Schemas
   - Data models
   - Reusable parameters
   - Response objects
   - Error schemas

4. Security Definitions
   - API key authentication
   - Bearer token
   - OAuth2 flows

5. Examples
   - Request examples
   - Response examples
   - Error examples

6. Tags and Organization
   - Logical grouping
   - Tag descriptions

7. External Documentation
   - Links to guides
   - Additional resources