Blobr is a no-code SaaS to create your API developer portal. API providers can manage, document, distribute and monetize API products from one place on their terms. Each portal is unique and each API provider has its own. They can add their branding and integrate the portal to their own environment. Blobr has been made so that both technical and non-technical profiles can succeed.
Swagger is a mix of open-source and commercial tools covering a large part of the API lifecycle, from API design and development to documentation and testing. It is based, and not to be confused with, the Swagger Specification - now the OpenAPI specification. SwaggerHub is the collaborative tool for teams and companies developing APIs.
Blobr’s API documentation - based on the OpenAPI specification - is built-in to be synced with API products, providing a personalized experience. API providers can provide use-case based instructions, making it easier for the user to consume the API. A “Try it out” button gives a quick response and a concrete illustration of the documentation. When an API is versioned and impacts an end-user, a customized changelog is sent. The documentation is always synced and changed accordingly. Automatic code snippets are generated so developers just need to copy paste the content in their code. Developers can as well follow the consumption and receive alerts when they reach certain thresholds.
Based on the OpenAPI specification and now under the SwaggerHub umbrella, the Swagger API documentation tool displays an automatically generated endpoint-based documentation, with a “Try it out” button. Designed for both an internal and external use, the documentation provides basic information to consume the API. The documentation is also kept up to date when a new version of the API is released.
For many years, Swagger used to be the go-to API Documentation tool. A specification that remains the standard for REST API Documentation. It is now named OpenAPI, while Swagger has become part of SmartBear and was rebranded with others API tools under the SwaggerHub umbrella.
And while new API Documentation tools have emerged, using the Open API spec - including Blobr - Swagger has remained the same. It still features an endpoint approach, useful for an internal use, but limited when it comes to sharing and selling an API to give more context. When the adoption of the API is key and the goal of the API Provider is to provide the clearest and most complete API Documentation possible, Swagger falls short and lacks the product approach that is now necessary.
As for versioning, Swagger handles the changes by updating automatically the documentation, but the changelog concerns the whole API, enabling breaking changes for external users.
Blobr uses the API-as-a-product angle to provide a self-contained API Documentation. It involves an API Product feature, enabling the API Providers to adapt the API to their clients’ use-cases. And a documentation based on them, that only displays what’s necessary to implement for end-users with contextual information (workflow, pictures, video), thus reducing the time to the first call.
And versioning - one of the main challenges for developers - is also supported. Since consumers’ use of APIs is known on Blobr, we ensure that versioning creates the least amount of burden. Blobr anticipates all the impacts of the newly added API. Products are updated accordingly. API consumers get changelogs information. Developer experience is finally improved.