Saturday, August 2, 2014

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

Friday, August 1, 2014

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.

Checkout the author Todd Fredrich as well.

Todd Fredrich specializes in RESTful Web services and platform APIs

About

Todd FredrichTodd Fredrich is an Internet-scale software architect and senior software developer specializing in RESTful Web services and platform APIs.  His framework, RESTExpress, facilitates rapid RESTful API development of extremely high-performance, scalable services supporting NoSQL back-end persistent storage, such as MongoDB, Cassandra, or Redis.
Currently working for Pearson Education at eCollege in Dever, Colorado, Todd supports teams in RESTful API development and messaging infrastructure tools, best practices and education.
Other sites of interest are: