Operations & Troubleshooting

Keeping Firestone Running Smoothly

This section provides practical guidance for operating and troubleshooting firestone workflows.

1. Troubleshooting Generation Failures

Diagnose and fix errors that occur during spec generation (syntax errors, invalid schema).

2. Troubleshooting Validation Errors

Identify and resolve issues where your API implementation doesn't match the generated contract.

3. Understanding OpenAPI Specifications

Interpret Firestone-generated OpenAPI specs and debug output structure.

4. Client & Server Generation

Workflows for using openapi-generator with Firestone outputs.

5. Running in Docker

Using the official Docker image for consistent builds.

6. Swagger UI Server

Operational tips for the built-in --ui-server.

Pages in this section:

• OpenAPI Ecosystem Integration
• Understanding the Generated OpenAPI Spec
• Running in Docker
• Advanced Pagination & Filtering
• Schema References & Reuse
• Client & Server Generation
• Using the Integrated Swagger UI Server
• JSON Schema Validation
• Naming Conventions
• Schema Design
• Authentication Patterns
• Generation Failures
• Versioning Strategies
• Design Philosophy
• API Design Principles
• Custom Templates
• Security Best Practices
• Security Schemes
• Multi-Resource APIs