Move from Visualize OpenAPI (Swagger) documentation to Legilio

Replace the OpenAPI (Swagger) documentation integration macro with Legilio, page by page. The macro comes from the Visualize OpenAPI (Swagger) documentation app by Dutch Beginners. Legilio runs on Atlassian, so your specs never leave it.

Where the spec comes from

The old macro’s settings show one of these:

• A spec typed or pasted into its editor. Copy it and paste it into Legilio.
• Store API definition as attachment. The file is already attached to the page. Pick it in Legilio.
• Remote location: a URL, GitHub, GitLab, Bitbucket, Azure DevOps or SwaggerHub. Download the file, attach it to the page and pick it in Legilio.

Steps

1. Keep the old app installed until you finish: its macro settings show where each spec comes from.
2. Edit the page, select the old macro and click the pencil icon to open its settings.
3. Type /legilio next to it, pick Legilio API Docs and set the spec as described above.
4. Check the docs, delete the old macro and publish the page.

If the old macro loaded the spec with a username, password or token, they’re stored in the page and its history. Change them once you’ve switched.

What works differently

Legilio has no Try it out and doesn’t load specs from URLs or Git, because it never connects to anything outside Atlassian.