540
Customers have installed this add-on in at least 540 active instances.
540
Customers have installed this add-on in at least 540 active instances.
    by O'Hara GroupAtlassian Verified
    O'Hara Group is an Atlassian Verified vendor. Verified vendors demonstrate Atlassian standards for add-on quality, reliability, and support.

    Learn more

    for Confluence Cloud and Confluence Server 5.4.3 - 6.3.1
    Supported
    O'Hara Group supports this add-on.

    Get support

    Supported
    O'Hara Group supports this add-on.

    Get support

    Data Center
    This add-on is compatible with the clustering and high-availability capabilities of our products.

    Generate beautiful documentation for your Open API (Swagger) compliant JSON or YAML definitions

    Generate beautiful documentation for your Open API (Swagger) compliant JSON or YAML definitions

    Generate beautiful API documentation

    Embed or link to JSON or YAML definitions

    Consume and interact

    From your Open API-compliant JSON or YAML, generate beautiful, interactive documentation in your Confluence pages.

    Paste your Open API-compliant JSON or YAML definition directly into the macro body, or fetch it from a URL.

    Use the interactive Try It Out! mode to test API operations directly from within Confluence. View the response body, status code and headers; or copy and paste the generated Curl command for later.

    Generate beautiful API documentation

    Embed or link to JSON or YAML definitions

    Consume and interact

    From your Open API-compliant JSON or YAML, generate beautiful, interactive documentation in your Confluence pages.

    Paste your Open API-compliant JSON or YAML definition directly into the macro body, or fetch it from a URL.

    Use the interactive Try It Out mode to test API operations directly from within Confluence. View the response body, status code and headers; or copy and paste the generated Curl command for later.

    More details

    There are no additional details.

    More details

    When upgrading to version 2.x (based on Swagger UI v3.x) from any earlier 1.x add-on version (based on Swagger UI v2.x), please be aware that there are some known issues, limitations and missing functionality that the Swagger UI team are still working on.

    If you rely on any of these features (listed in the version 2.x release notes), you may wish to remain on the older version until these have been addressed.

    As each bug and missing feature is addressed in Swagger UI, we will publish new versions of the add-on.

    User reviews

    (9)
    Sign in to write a review
    by Florian Berger on 2017-06-02
    Excellent Support! Thank you!
    Was this review helpful?YesNo
    by Simon D. Kim on 2016-12-20
    The plugin stopped working for me today and currently returns the following message: `Unauthorized: Could not find stored client data for xxx. Is this client registered?` EDIT: I sent an email to support and they got back to me very quickly and told me that it might be an issue with Atlassian side. It was fixed by uninstalling and installing again.
    Was this review helpful?YesNo
    by Heesuk Ahn on 2016-11-24
    it's work for me . but it's so late in confluence
    0 out of 3 found this review helpful
    Was this review helpful?YesNo
    by Sanjiv Gupta on 2016-11-13
    Doesn't work for me. always pop-up a message saying "not responding, wait or Cancel"
    0 out of 2 found this review helpful
    Was this review helpful?YesNo
    by Alexey Dmitriev on 2016-09-21
    No support of examples
    0 out of 2 found this review helpful
    Was this review helpful?YesNo

    Pricing

    Pricing details are loading…

    Pricing details are loading…

    Paid-via-Atlassian pricing FAQ

    How does cloud add-on pricing work?

    Cloud pricing is subscription based. You are eligible for support and automatic version updates as long as your subscription is active.

    When your subscription renews each month, you are automatically billed for host products and add-ons based on the number of users in your instance.

    If add-on pricing changes after your initial purchase, there's a 60-day grandfathering period during which you can renew based on the old pricing.

    How do I determine my cloud pricing?

    Add-ons are billed based on the number of users in your host product. Confluence Cloud add-ons are priced based on the number of Confluence users on your instance. For example, if you have Confluence Cloud (25 users), you pay the 25-user price for add-ons.

    The pricing structure for cloud products and add-ons will be changing July 31, 2017, as follows:

    • Monthly subscriptions with up to 10 host product users are billed at a flat rate price.
    • Monthly subscriptions with more than 10 users are billed per user, starting at the first user.
    • Monthly subscriptions with more than 100 users are billed per user. The table above provides example pricing at various user levels.
    • If per-user pricing is not yet available for this add-on, please contact the vendor for further information.

    If you've opted for annual billing for your host product, add-ons are also billed annually at a discount (12 months for the price of 10).

    Do you offer academic, community, or open-source licenses?

    Academic, community and open source licenses are not available for cloud add-ons.

    Can I extend my free trial?

    For cloud add-ons, you cannot extend your free evaluation period. All cloud add-ons are immediately subscribed by a user, and we provide a free evaluation period. This is a minimum of 30 days and ends on the second billing cycle after you first subscribe to the add-on.

    Paid-via-Atlassian pricing FAQ

    How does server add-on pricing work?

    Server products and add-ons are hosted on your servers. Licenses are perpetual and the purchase price include 12 months of maintenance (support and version updates).

    You can renew maintenance after 12 months at 50% of the current purchase price. You can upgrade the tier of your host product and add-on licenses at any time. Upgrade prices are calculated based on Atlassian's formula (view example).

    If add-on pricing changes after your initial purchase, there's a 60-day grandfathering period during which you can renew based on the old pricing.

    How do I determine my server pricing?

    Add-ons are billed based on the number of users in your host product. The add-on tier should match the licensed user tier of the Atlassian host product. For example, if you have a Confluence Server license for 25 users, you should purchase the 25-user tier for add-ons. Even if fewer users want to use the add-on than your host product license, the two licenses should match exactly.

    Do you offer academic, community, or open-source licenses?

    For server add-ons, purchase and renewal is half-price if you have an academic license for your Atlassian host product. Server add-ons are always free for community and open-source licenses.

    For more details about qualifying for special licenses, see here.

    Can I extend my free trial?

    For server add-ons, you can extend your add-on trial up to 5 times - in other words, for up to six months. Extend your trial by generating a new evaluation license key from Atlassian Marketplace. Click Try it free and you'll be directed to generate a new license. Paste this license key into the add-on listing in UPM from your Atlassian host product, and you're all set.

    How can I buy add-ons for my legacy JIRA Server or Confluence Server license?

    If you own a legacy JIRA Server Unlimited (100+ users) or Confluence Server Unlimited (2000+ users) license purchased in 2012 or earlier, legacy add-on pricing is no longer available. You have two options for add-on purchasing:

    • Purchase the add-on at the non-legacy Unlimited (10000+ users) tier.
    • Renew your JIRA or Confluence license at a non-legacy tier, then purchase the add-on at the same tier.

    Learn more

    O'Hara Group is an vendor, committed to providing support for their add-ons at least 8 hours a day, 5 days a week.

    O'Hara Group is an vendor, committed to providing support for their add-ons at least 8 hours a day, 5 days a week.

    Vendor support resources

    Documentation

    Find out how this add-on works.

    See existing Q&A in Atlassian CommunityAsk a question in the Atlassian Community

    Atlassian-hosted discussions connect you to other customers who use this add-on.

    Documentation

    Find out how this add-on works.

    See existing Q&A in Atlassian CommunityAsk a question in the Atlassian Community

    Atlassian-hosted discussions connect you to other customers who use this add-on.

    Versions

    Confluence Cloud Released 2017-07-20

    Summary

    Admin restrictions, sort and filter tags, show Try it out request duration

    Details

    What's new in version 1.1.8-AC:

    • Sort tags (by alpha or definition order)
    • Show Try it out request duration (in milliseconds)
    • Limit the number of tags displayed

    What's new in version 1.1.8-AC for administrators:

    • Enforce or prevent JSON/YAML definitions from a URL
    • Whitelist allowed hosts for JSON/YAML definition URLs

    What's new since version 1.1.5-AC:

    • Visual redesign, aligned with Swagger Editor
    • Faster performance
    • Better validation
    • Better support for future Open API spec versions (beyond 2.0)

    Browser/Open API spec support:

    • Supports Open API spec 2.0 (older 1.0 and 1.1 specs no longer supported)
    • Works in latest Chrome, Safari, Firefox, Edge and IE11

    Features not yet implemented in Swagger UI v3.x:

    • Show models as (schema or model)
    • JSON editor (for editing complex bodies)
    • Show request headers (show the Try it out request headers)
    • Enable cookies (include cookies in Try it out requests)
    • Supported Try it out methods (operations allowed in Try it out, or disable completely)

    Versions

    Version 2.2.0 Confluence Server 5.4.3 - 6.3.1 Released 2017-07-19

    Summary

    Admin restrictions, sort and filter tags, show Try it out request duration

    Details

    What's new in version 2.2.0:

    • Sort tags (by alpha or definition order)
    • Show Try it out request duration (in milliseconds)
    • Limit the number of tags displayed

    What's new in version 2.2.0 for administrators:

    • Enforce or prevent JSON/YAML definitions from a URL
    • Whitelist allowed hosts for JSON/YAML definition URLs

    What's new in version 2.x:

    • Visual redesign, aligned with Swagger Editor
    • Faster performance
    • Better validation
    • Better support for future Open API spec versions (beyond 2.0)

    Browser/Open API spec support:

    • Supports Open API spec 2.0 (older 1.0 and 1.1 specs no longer supported)
    • Works in latest Chrome, Safari, Firefox, Edge and IE11

    Features not yet implemented in Swagger UI v3.x:

    • Show models as (schema or model)
    • JSON editor (for editing complex bodies)
    • Show request headers (show the Try it out request headers)
    • Enable cookies (include cookies in Try it out requests)
    • Supported Try it out methods (operations allowed in Try it out, or disable completely)

    Installation

    1. Log into your Confluence instance as an admin.
    2. Click the admin dropdown and choose Atlassian Marketplace. The Manage add-ons screen loads.
    3. Click Find new add-ons from the left-hand side of the page.
    4. Locate Open API Documentation for Confluence via search. The appropriate add-on version appears in the search results.
    5. Click Try free to begin a new trial or Buy now to purchase a license for Open API Documentation for Confluence. You're prompted to log into MyAtlassian. Open API Documentation for Confluence begins to download.
    6. Enter your information and click Generate license when redirected to MyAtlassian.
    7. Click Apply license. If you're using an older version of UPM, you can copy and paste the license into your Confluence instance.

    To find older Open API Documentation for Confluence versions compatible with your instance, you can look through our version history page.

    1. Log into your Confluence instance as an admin.
    2. Click the admin dropdown and choose Add-ons. The Find new add-ons screen loads.
    3. Locate Open API Documentation for Confluence.
    4. Click Free trial to download and install your add-on.
    5. You're all set! Click Close in the Installed and ready to go dialog.

    Similar add-ons