Forum Discussion

bjolletz's avatar
bjolletz
Occasional Contributor
3 years ago

Organization-level integrator landing page

Hi! I'm new to Swaggerhub and trying to get my head around how Swaggerhub can be used from an API client's perspective. I was assuming there would be something like a public organization-level landin...
bjolletz's avatar
bjolletz
Occasional Contributor
3 years ago

Thanks, that's kind of what I was looking for!

 

However, what I also would be interested in is some kind of "developer portal" for integrators, where I can put some general info about our APIs, how to use them, how to set up auth etc. A landing page where I can direct all our integration partners. Does Swaggerhub offer anything like this or should I set this up myself using some external tool like Github pages etc.?

  • joejoyce's avatar
    joejoyce
    Staff
    3 years ago

    Good stuff, we're getting there! For the further use case (a portal where you can add more broad info about API usage, authentication, etc.) I would ask, do you and your team use Confluence? We recently launched a SwaggerHub plugin for Confluence that embeds and synchs your SwaggerHub docs within a Confluence portal, but with the added bonus of being able to add the "external" info you've described while still having it synced with any changes that happen to the API design in SwaggerHub. If that sounds like it might do the trick, here's the link to the plugin: https://marketplace.atlassian.com/apps/1228834/swaggerhub-integration-for-confluence?hosting=cloud&tab=overview. 

    • bjolletz's avatar
      bjolletz
      Occasional Contributor
      3 years ago

      We do actually use Confluence so this sounds interesting and we'll check it out. Currently we host our API partner pages on Github pages though, so we'll see if it's worth the hassle to move it. Otherwise I think keeping the API partner pages on Github pages would also be fine, and then just link to Swaggerhub for the API specs.

       

      Anyhow, thanks a lot for your help!