How can I generate API referance from swagger 2.0 docs?

[dsha256]

I have generated swagger 2.0 docs through the proto tooling. Now I want to put my JSON docs into fumadocs project and generate an appropriate MDX files for it. Is this feasible at all?

[fuma-nama]

We support 3.0 and 3.1, 2.0 is supported by using Scalar's parser which is currently experimental. I will highly recommend to use 3.0 if your tool supports it

[dsha256]

I converted my Swagger v2 to Open API 3.1 using their official online converter, but when I try to generate MDX in my Fumadocs project it doess the job, however I can't load the page in the browser. Here is the err:

Error: Expected component `APIPage` to be defined: you likely forgot to import, pass, or provide it.
It’s referenced in your code at `13:1-13:162` in `/Users/dsha256/js/my-docs/content/docs/payment-service_-charge-subscription.mdx`
    at _missingMdxReference (rsc://React/Server/webpack-internal:///(rsc)/./content/docs/payment-service_-charge-subscription.mdx?collection=docs&hash=0949aa27abd3c373b3ce53522bb37d28?0:64:11)
    at _createMdxContent (rsc://React/Server/webpack-internal:///(rsc)/./content/docs/payment-service_-charge-subscription.mdx?collection=docs&hash=0949aa27abd3c373b3ce53522bb37d28?1:33:19)
    at MDXContent (rsc://React/Server/webpack-internal:///(rsc)/./content/docs/payment-service_-charge-subscription.mdx?collection=docs&hash=0949aa27abd3c373b3ce53522bb37d28?2:61:16)
    at resolveErrorDev (webpack-internal:///(app-pages-browser)/./node_modules/.pnpm/[email protected][email protected][email protected][email protected]/node_modules/next/dist/compiled/react-server-dom-webpack/cjs/react-server-dom-webpack-client.browser.development.js:1792:63)
    at processFullStringRow (webpack-internal:///(app-pages-browser)/./node_modules/.pnpm/[email protected][email protected][email protected][email protected]/node_modules/next/dist/compiled/react-server-dom-webpack/cjs/react-server-dom-webpack-client.browser.development.js:2071:17)
    at processFullBinaryRow (webpack-internal:///(app-pages-browser)/./node_modules/.pnpm/[email protected][email protected][email protected][email protected]/node_modules/next/dist/compiled/react-server-dom-webpack/cjs/react-server-dom-webpack-client.browser.development.js:2059:7)
    at progress (webpack-internal:///(app-pages-browser)/./node_modules/.pnpm/[email protected][email protected][email protected][email protected]/node_modules/next/dist/compiled/react-server-dom-webpack/cjs/react-server-dom-webpack-client.browser.development.js:2262:17)

I'm following the instructions given here (https://fumadocs.vercel.app/docs/ui/openapi). Used tags such as APIPage is not used in existing pages too, after init. Btw adding that import does not help.

[fuma-nama]

you need to pass it to MDX components like https://fumadocs.vercel.app/docs/ui/openapi#configure-pages

[dsha256]

Thank you @fuma-nama