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:

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