APIs are the neural connections of the digital economy, allowing systems to connect, collaborate, and converse with meaningful data. But these connections don't start with fully working APIs; they start with API design.
And API design is human. People work together across boundaries to create a specialized micro-language for domain-specific interaction; to implement that language as an API, verify that it works, and make it as easy as possible for client developers to understand the API and put it to good use.
RepreZen helps connect your API designs, your team, and your development environment, so you can connect your systems. With the new 1.5 release, RepreZen API Studio takes this to a new level: better code gen, synchronized documentation, Eclipse IDE integration, and obsessively thorough multi-file support.
Multi-File to the Core
Is your Swagger spec too big to navigate and maintain easily? Have you wished you could split your Swagger spec into manageable parts, share schemas or other elements across API specs, and maybe even centralize these in a shared repository?
API Studio 1.5 incorporates cross-file references into every part of the API design process: content assist, hyperlink and outline navigation, documentation, and even code generation. Some recent improvements:
- The code generation toolbar drop-down menu now lets you run any GenTarget or group from a component file in a multi-file project. So you don't have to select your top-level Swagger spec to generate code. Just select what you want from the toolbar menu, and that becomes the default for one-click codegen.
- Swagger Normalizer combines multi-file projects into a single Swagger spec to simplify downstream codegen and documentation UI. In the 1.5 release, Swagger Normalizer generates both JSON and YAML formats, and lets you control element ordering.
- Watch the new video walkthrough of multi-file Swagger features in API Studio. You'll find it in the dashboard, on our YouTube channel, or right here:
Want to take a look?
Get a free trial today.
New Scroll Sync and Go-To-Definition in Live Documentation View
You'll see some welcome improvements in the new API Documentation View:
The documentation view automatically synchronizes to the editor by scrolling to the selected element. You can toggle this feature on and off, using the Link with Editor button in the upper-right of the Documentation View.
The new Go-To-Definition buttons select the path item or method in the editor, allowing easy navigation from the Documentation View to the editor. And of course it's multi-file aware, so it navigates through $ref properties to the referenced element.
Thanks to Meinrad Hermanek at Finnova for the suggestions! Here's a quick demo:
NSwag .NET Web API and TypeScript Code Generators
RepreZen API Studio now has 70+ code generators and counting.
The 1.5 release includes the popular NSwag generators for .NET, Web API and TypeScript. NSwag GenTemplates run on Windows, and require a simple configuration in preferences:
RepreZen API Studio on Eclipse Marketplace
RepreZen is proud to join the Eclipse Foundation as a Solution Member. And we're now offering RepreZen API Studio on the Eclipse Marketplace.
Now, Eclipse developers can install API Studio directly into the IDE, for seamless API design and development.
You can install API Studio in either of these two ways:
- Install Standalone on Windows, MacOS or Linux.
- Drag-and-Drop from Eclipse Marketplace to your own Eclipse IDE distribution (Mars.2 or later), or install directly from the Eclipse Marketplace client in Eclipse.
Whether you choose our Eclipse distro or your own, you're getting a fully functional IDE, optimized for API design, documentation & development.
- New installer improves the UX and correctly handles JRE requirements on all platforms.
- Mac-native application layout allows launching API Studio directly from the Applications folder.
- The code generation menu on the toolbar now allows you to create a new GenTarget.
- New code generation and multi-file videos are included in Dashboard.
Full release notes here. Happy modeling! :-)