Known Limitations and Compatibility

Known Limitations & Compatibility

This page lists current caveats to help you plan your workflows.

Platform support

• macOS (Apple Silicon arm64) is first‑class via Homebrew cask.
• Other platforms: Use the distribution bundle with JDK 17+.

Certificates & SSL

• Disabling SSL verification is intended only for dev/test.
• Custom CA bundles are supported via PEM files; ensure the PEM includes intermediate certs when required.

Response size

• Large responses are truncated at the configured Max response size. A header x-swaggerific-truncated: true is added and a notice is appended to the body.

OpenAPI variations

• JSON and YAML are supported for local files. For URLs, the endpoint should return JSON.
• Very large specs may require using the Expand/Collapse Tree actions for smooth navigation.

Shortcuts

• Defaults are provided and can be customized in Settings. Some OS/global shortcuts may conflict; adjust as needed.