It’s been two weeks since the release of RAML 1.0 (RC), the new raml.org website, and the API Workbench; all been very well received in the community. A lot happened in this two weeks, so let me share some details on the release and quotes we had from the community on different channels.
It's a big day for RAML. We're excited to announce the publication of the RAML 1.0 (RC) spec, as well as the launch of a gorgeous new RAML.org site. In addition, our community is now launching a set of brand new development tools that support RAML 1.0 as well as 0.8. Here's what you need to know.
What's new with RAML 1.0?
RAML has always been about making it easy for developers to manage the whole API lifecycle from design to implementation to operation and sharing. It's a concise, intuitive language for specifying APIs that allows developers to only write what they need to define an API, drawing from and contributing to commonly-used patterns, such as the YAAS (SAP hybris) pattern library.
We’re about to finalize the next version of RAML. Last month we published the result of many months of community feedback, development modeling, and API analysis, in which we figured out how a rather small number of changes in RAML 1.0 (relative to its predecessor, RAML 0.8) could result in dramatic improvements to the modeling capabilities. The list resolves some gaps, enhances capabilities, and maintains the simplicity of RAML. This month, that list will turn into RAML 1.0.
Why so few changes?
I am really happy to post a new article in our category [Guest Posts]. This time, Kai Spichale talks a little bit about the API first approach with RAML. I hope you will enjoy his article and thank you Kai for contributing!
There is no standard to describe REST APIs but different formats and best practices emerged over time and profited from the experiences of their respective predecessors. The latest addition to this series is RAML, a "RESTful API Modeling Language" that is discussed in this article as an important tool for API First Development.
Hi @all, we are proud to announce that we were able to add a couple of new projects to our list. Check them out on: raml.org/projects.html Here an overview:
Currently we are compiling a series of guest posts where we ask happy RAML user to tell their stories about how they are using RAML, or their tools they developed and contributed to the RAML community. In our very first post in this series, I am happy to have ePages to talk about their experience and the tool they developed. If you want to talk about your story or tool, why not sending us an email to email@example.com.
Today, InfoQ released an interview with Uri Sarid, the founder of the RAML project. Uri is talking about the current status of the project, the new sponsorship of the Swagger project from SmartBear, and also scratches a little bit on RAML 1.0. Enjoy the full interview here.
MuleSoft has released a couple of new key features around their Anypoint Platform offering in February 2015. One in particular is interesting for the RAML community. The RAML console got a refreshed UI as well as new features which I will briefly explain here.Before we start, for everyone who does not know the console, let’s have a quick overview of it. The RAML console is an open source application and gives you a graphical insight of your API specification. It lists all resources and by clicking on the attached HTTP verbs on a specific resource you will be able to deep dive into the resource details. The detail page features a general description, descriptions of every possible HTTP status, examples and schemas on the response’s and/or request’s body, and other aspects you defined in your RAML specification.So what really is new? As I said - the UI was completely refreshed and got a more modern look & feel.
Almost exactly a year ago, the RAML workgroup released the first public version of the RESTful API Markup Language spec, RAML 0.8, along with some tooling and a website. It's been one heck of a year, in which we saw massive adoption across users and companies large and small; active discussions online and at conferences and meetups; a community of tool developers on raml.org and on github with a vibrancy we could only dream of; and virality: developers leveraging other developers' work in a chain of value.
A Deep Dive into IoT, RAML, and Robot APIs
I've been thinking a lot recently about the Internet of Things (IoT), in its numerous variations. Like all popular memes, it's used and abused in numerous ways. But a core concept is to connect to the network things that are not traditionally thought of as connected – toasters, locomotives, roads, even network devices themselves (think Software Defined Networking, or SDN). Some of those things are dumb, but useful: temperature sensors, pedometers, trip switches, lightbulbs. But I wanted to think on the other side of the spectrum: what are some things that are smart, or at least that can do a lot more than just turn on or off or send out a reading? Where can I find truly creative ideas for interesting things that are even more interesting when networked?