Blog

Now with more expressivity than before, Restlet Studio is the easiest and most accurate way to design your APIs, and export them to OAS / Swagger with absolute precision. These improvements are all included in your automatically generated and hosted API documentation. Restlet Studio is growing to meet the demands of its community of API […]

- March 27, 2017
Read article

Create, collaborate, manage and publish API documentation generated from open standards RAML, Swagger San Mateo, Calif., December 7, 2016 – Restlet, providers of the fastest and easiest platform for delivering APIs, today announced the availability of new technology, code-named Gutenberg, to automatically create and publish API documentation. Gutenberg is immediately available as part of Restlet Studio […]

- December 07, 2016
Read article

For some time now, you have been asking for a way to share a read-only view of your API design with others involved in your API project. From now on, every Restlet Studio API will have an associated API documentation. Just open the new API settings page, click publish, and you’re good to go. Sleek and […]

- November 21, 2016
Read article

I had the pleasure of writing an article for Nordic APIs on Web API definition languages. If you’re into the world of Web APIs, you’ve probably heard of formats like Swagger, RAML or API Blueprint. They allow developers to define the contract of the API, with its endpoints, its resources, its representations, allowed methods, the […]

- May 10, 2016
Read article

API definitions are the communication nexus for you frontend and backend teams, for your API consumers and producers — both inside and outside your company. They are a central element of your API strategy. But authoring good API definitions can be challenging, as you need to know the trickier details of the underlying specifications. Restlet […]

- May 04, 2016
Read article

Working on API tooling and services at Restlet, we’ve come across really odd API definitions coming from our users and customers. You’d be surprised to see all the errors we found in them! Sometimes, API definitions are simply not even valid JSON or YAML files, so they can be hard to parse, and other times, […]

- April 07, 2016
Read article

Let’s have a sneak peek at a new feature of the DHC API testing tool: the ability to import a whole Swagger 2.0 API definition! Launch DHC (or install it from the Chrome Web Store), and look at the new import feature, in the bottom left hand corner: Let’s pick up the Swagger file: And […]

- March 29, 2016
Read article

In a previous post, we discussed what APISpark can bring to existing Web APIs and more specifically to those implemented with the Restlet Framework. This leverages the Connector feature that allows you to proxy existing Web APIs hosted outside the APISpark platform to easily apply services like API call monitor, analytics, rate limitations, etc. Since […]

- January 12, 2016
Read article

In the first part of this article, we described the key features of APISpark connectors and what they can bring to existing Web APIs. We will focus here on how to plug existing Web APIs written with Restlet Framework on the platform. Getting Swagger definition from Restlet Framework applications As we saw, creating the Swagger definition of […]

- January 04, 2016
Read article

The APISpark platform lets you craft your Web API very easily and then host it, but it’s not the only supported feature. The platform supports three different components as emphasized in the following figure: In addition to Web APIs, Descriptors allow you to design a Web API by, creating a structure from scratch or importing […]

- December 28, 2015
Read article