API Documentation using Openapi

[atulraj85]

I am using zenstack with nextjs 15. I created a zmodel file and added the plugin to generate documentation for API.

plugin openapi { provider = '@zenstackhq/openapi' output = './openapi.yaml' title = 'My awesome API' version = '0.5.0' summary = 'Created with ZenStack' description = 'My awesome API created with ZenStack' prefix = '/api' }

Then I generated the file, it is about 1.4mb. I tried rendering that file to UI it is taking too much of RAM and crashes the site. Then I uploaded that file to online openapi viewer, it crashed that site too.

I am unaware of how to fix / use it. please help.

There are about 15 (mode) tables in my schema.

[ymc9]

Hi @atulraj85 , by default the openapi plugin emits a schema for each type PrismaClient generates. you can use the "omitInputDetails" to reduce the fidelity of the output and get a smaller result:

https://zenstack.dev/docs/reference/plugins/openapi#options