Skip to main content
Skip table of contents

Swagger/OpenAPI macro

Get started with showcasing API endpoints with the Swagger/OpenAPI Macro.

Welcome to our guide on using the Swagger/OpenAPI Macro in Confluence. This powerful tool is designed to help you seamlessly integrate and display API documentation directly within your Confluence pages.

https://www.youtube.com/watch?v=whQ4-2rC1hU

Whether you're documenting a new API or integrating existing API specifications into your project documentation, the Swagger/OpenAPI Macro makes it easy to visualize and interact with API endpoints.

  • Interactive Documentation: Present your API documentation in an interactive format that allows users to explore endpoints, try out API calls, and see responses in real time.

  • Easy Integration: Embed your Swagger or OpenAPI files directly into Confluence, ensuring that your documentation is centralized and accessible to your team.

  • Real-Time Updates: Any changes to your API specifications are automatically updated in the documentation displayed in Confluence, keeping your project stakeholders informed with the latest data.

image-20241027-115959.png

1. Open the editor and type /swagger and press Enter

image-20241027-120035.png

2. Choose the source of the documentation

image-20241027-120059.png

3. Click Save and you’re done!

image-20241027-120138.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.