Series: API Design Best Practices (by MuleSoft)

MuleSoft is very well known in the API space and I personally have used and promoted RAML and is usually compared with Swagger (2.0).  These series of posts from them will be very useful for anyone delving into RESTful APIs.

API design best practices series

• Part 1: Planning Your API 
• Part 2: Spec Driven Development 
• Part 3: Nouns, CRUD, and More 
• Part 4: Hypermedia 
• Continue Reading on Hypermedia 

I will keep updating this post as and when MuleSoft publishes theirs.

HATEOAS, REST, and Hypermedia Primer

HATEOAS, REST, and Hypermedia Primer with Mat Velloso

The RESTful CookBook: How to do stuff RESTful

The RESTful CookBook: How to do stuff RESTful

REST is hot! And REST is finally rediscovered by API programmers all over the world. But REST isn't always as easy as it seems on first look. Dealing with HATEOAS, Code on demand and uniform interfaces can be really tricky and many people will fall back to not-so-restful approaches when things are starting to become more difficult. But it doesn't need to be. Once you get to know REST, you will like it.

The RESTful cookbook website is inspired by the puppetcookbook from Dean Wilson, who created cookbook recipes on how to deal with some of the issues people are facing over and over again when using the Puppet Configuration management tool. This site however, is about dealing with issues and questions people are facing over and over again when trying to create RESTful APIs.

This site is created by Joshua Thijssen and is available on github, so you can always add or update information if you like. With more contributions, this site can become the place where you can find all answers to your RESTful questions once and for all.

RESTFrameworks - implementing-rest

Exploring the implementation aspects of the REST architectural style.
List of known frameworks that have REST aspects 

NOTE: If you are an author/advocate of a framework listed here, feel free to contribute to the wiki to improve the accuracy of the data. If you know of a REST-ful framework/library that is not listed here, contact one of the project members to add it to the list.

Its been a while since this has been updated, so this could just be for informational purposes.

Another API-Blueprint, RAML and Swagger Comparison

Another API-Blueprint, RAML and Swagger Comparison 

RAML vs. Swagger vs. API Blueprint

Please read the analysis completely...
http://www.mikestowe.com/2014/07/raml-vs-swagger-vs-api-blueprint.php

Overall Tallies:

RAML: 6 wins
Swagger: 4 wins
API Blueprint: 2 wins

Overview: Each project brings different strengths and weaknesses to the table, and in the end it’s really about what strengths you need, and which weaknesses you cannot afford.  Overall, RAML fared the best in these different categories, and while the developer community is not as large as the others I think it’s safe to say it will keep growing.

Overall Winner: RAML

Learn REST: A RESTful Tutorial

Learn REST: A RESTful Tutorial

Building restful web services, like other programming skills is part art, part science. As the Internet industry progresses, creating a REST API becomes more concrete, with emerging best practices. As RESTful Web services don't follow a prescribed standard except for HTTP, it's important to build your RESTful API in accordance with industry best practices to ease development and simplify client adoption.

Presently, there aren't a lot of REST API guides to help the lonely developer. RestApiTutorial.com is dedicated to tracking REST API best practices and making resources available to enable quick reference and self education for the development crafts-person. We'll discuss both the art and science of creating REST Web services.

Jump in with What Is REST?, an overview concepts and constraints of the RESTful architecture.

Get Started »

Checkout the author Todd Fredrich as well.