Nice!
I wonder if scalar could be integrated into oaskit just like redoc is. Do you had to customize this block a lot, or is the default generally fine?
<script>
Scalar.createApiReference('#app', {
// The URL of the OpenAPI/Swagger document
url: 'https://registry.scalar.com/@scalar/apis/galaxy?format=json',
// Avoid CORS issues
proxyUrl: 'https://proxy.scalar.com',
})
</script>
I took the approach of building my own DSL. The code is available here:
myapp_api_spec/*.mix cat.gen.spec generates the OpenAPI documentation:mix cat.gen.spec.requests generates request validation modules, such as lib/cat_web/generated/admin_audits_request.ex.mix cat.gen.spec.schemas generates schema modules, such as lib/cat_web/generated/admin_audit.ex, which can be used for responses.mix cat.gen.spec.yaml generates the OpenAPI documentation.Under the hood, it uses open_api_spex. However, open_api_spex is too dynamic for my needs, so I use commands to generate the request validation modules ahead of time, in a way similar to go generate.
