Backstage — Publicize and Share Your APIs.

<p>Developers often spend a lot of time designing and building well formed APIs. They function as advertised and follow industry standards and get deployed to production. But what good is this if their use is documented in a short wiki page or a word document that is not maintained. This is like a car manufacturer building a beautiful sleek sports car and never letting anyone drive it.</p> <h1>What is a Developer Portal</h1> <p>Backstage is much more than just a&nbsp;<strong>Developer Portal</strong>, but let&rsquo;s start out and define what a development portal is and what benefits it can bring. If you are familiar with Swagger UI than you have seen a basic development portal.</p> <blockquote> <p>A development portal is automatically generated (in this case of Swagger from annotations), customizable website that contains the documentation of your APIs. This includes the API signature, the schema, error information (e.g. HTTP error codes) and response information. In summary it is where the consumers of your API can find and learn about your APIs and try them out.</p> </blockquote> <p>There are many development portal frameworks available including from leading API Gateway vendors such as Axway, IBM or other API management solutions. Finally, specific software for building a complete developer portal solution. In this article we are going to look at an open source alternative called&nbsp;<a href="https://backstage.io/" rel="noopener ugc nofollow" target="_blank">Backstage</a>.</p> <p><a href="https://blog.stackademic.com/backstage-publicize-and-share-your-apis-dcc7026ae7b6">Click Here</a></p>
Tags: APIs Backstage