Latest advances give Entando a new Swagger
Entando, always one for embracing integration between applications, now has even more bounce in its step when working with outside software. The obvious pun to make is to say it has more swagger, but we’ll play it straight and act like we’ve been here before.
Entando now has Swagger. Period.
With the release of Entando 5.0.2, Entando has enabled Swagger - a utility for developers to detail their APIs so that their applications can cleanly interface with outside machines - on all of the REST endpoints exposed by the MApp engine. Swagger allows developers to quickly evaluate and integrate with all of the Entando APIs to enhance and integrate Entando applications with external data sources and applications.
Developers working in an Entando application can also include custom built APIs by enabling Swagger and adding a configuration to capture the REST controllers inside their Entando application. Learn more about adding APIs to an Entando application here: http://docs.entando.com/#_building_a_rest_api
The Swagger documentation is also integrated with the Entando Authorization and Authentication model driven by Spring Security inside of an Entando application. The integration with the security framework allows developers to execute and evaluate Entando endpoints in a browser to test the APIs in real time without making adjustments to the code.
Example Authorization page:
All Entando APIs include annotations that document the response model from a given endpoint inside the Swagger definition. For example, you can review the data model for the AttributeType response via Swagger in the browser.
The Entando MApp engine exposes APIs for:
- Activity streams
- System configuration
- Content models
- Dashboard data
- Data object models
- Data types
- Database operations
- Entity managers
- File browser
- GUI Fragments
- Page Configuration
- Page Models
- Profile Types
- User Settings
- OAuth errors and white label management