undefined

**Step 2: OpenAPI 3.1 Specification**
```yaml

Category:
  type: object
  required: [id, name, slug]
  properties:
    id:
      type: string
      example: "cat_1"
    name:
      type: string
      example: "Electronics"
    slug:
      type: string
      pattern: '^[a-z0-9-]+$'
      example: "electronics"
    parent_id:
      type: string
      nullable: true

Error:
  type: object
  required: [error]
  properties:
    error:
      type: object
      required: [code, message]
      properties:
        code:
          type: string
          description: Machine-readable error code
          example: "invalid_parameter"
        message:
          type: string
          description: Human-readable error message
          example: "The 'price' parameter must be a positive number"
        details:
          type: object
          description: Additional error context
          additionalProperties: true

NotFound:
  description: Resource not found
  content:
    application/json:
      schema:
        $ref: '#/components/schemas/Error'
      example:
        error:
          code: "resource_not_found"
          message: "Product with ID 'prod_999' not found"

InternalServerError:
  description: Internal server error
  content:
    application/json:
      schema:
        $ref: '#/components/schemas/Error'
      example:
        error:
          code: "internal_server_error"
          message: "An unexpected error occurred. Please try again later."
          details:
            request_id: "req_abc123"

**Step 3: Generate Documentation**
```bash

---
---

// Endpoint 1: Login failure
{
  "error": "Invalid credentials"
}

// Endpoint 2: Validation failure
{
  "errors": [
    { "field": "email", "message": "Invalid email format" }
  ]
}

// Endpoint 3: Server error
{
  "status": "error",
  "message": "Internal server error",
  "code": 500
}

// Problem: Clients need custom error handling per endpoint

// Standardized error response (all endpoints)
{
  "error": {
    "code": "invalid_credentials",
    "message": "The provided email or password is incorrect",
    "details": null,
    "request_id": "req_abc123"
  }
}

// Validation errors (multiple fields)
{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields failed validation",
    "details": {
      "fields": [
        { "field": "email", "message": "Invalid email format" },
        { "field": "password", "message": "Password must be at least 8 characters" }
      ]
    },
    "request_id": "req_def456"
  }
}

// Client-side error handling (consistent)
function handleApiError(response) {
  const { code, message, details } = response.error;
  
  switch (code) {
    case 'validation_failed':
      // Display field-specific errors
      details.fields.forEach(({ field, message }) => {
        showFieldError(field, message);
      });
      break;
    
    case 'unauthorized':
      // Redirect to login
      redirectToLogin();
      break;
    
    default:
      // Generic error message
      showToast(message);
  }
}