OpenAPI

Generate OpenAPI 3 documentation for Payload CMS endpoints.

Community 140 3.1k/wk MIT v1.4.0

Installation

pnpm add payload-openapi

About

The OpenAPI for Payload CMS plugin creates comprehensive OpenAPI documentation for your API endpoints defined in a Payload CMS application. This includes support for collection endpoints, global and custom endpoints, and authentication requirements. The documentation generated is fully typed, ensuring accurate representation of requests, responses, and parameters. To integrate, use the `createDocument` function, passing your Payload configuration and optional parameters for customized output. Documentation can incorporate additional OpenAPI details from external sources like `package.json` and optional `.openapi` files for merging custom schemas. The plugin allows for extensive configuration to exclude specific paths or to omit access analysis for selected collections. This plugin serves as a valuable tool for developers looking to document their APIs accurately, promote understanding of their available endpoints, and facilitate easier collaboration and integration with other services.

Package info

Package name
payload-openapi
Latest version
1.4.0
Unpacked size
109 kB
License
MIT
Weekly downloads
3.1k
Last publish
Jul 15, 2023

More from teunmooij

View profile

Similar plugins

More in Devtools