Saturday, August 2, 2014

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

Friday, August 1, 2014

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.

Todd Fredrich specializes in RESTful Web services and platform APIs

About

Todd 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:

Monday, July 21, 2014

API Craft : Google Group

Welcome to API Craft. We <3 APIs.

Our standards are simple - we are a community of individual API practitioners who see building APIs as a craft.

We represent our own opinions, and not that of employers or anyone else.

This list is open to thoughtful posts from prospective employers who want great API thinkers and doers.

This list is not open to posts from vendors who are promoting their products or spamming recruiters.

Come on in, read, search for questions you may have about APIs, and then feel free to hop into the conversations.

Welcome!

Link to the group: https://groups.google.com/forum/#!forum/api-craft

Tuesday, September 17, 2013

Eve: Python REST API Framework

Powered by Flask, MongoDB, Redis and good intentions Eve allows to effortlessly build and deploy highly customizable, fully featured RESTful Web Services
Check out the Eve homepage

GitHub

Eve is an out-of-the-box, highly customizable and fully featured RESTful Web API framework that you can use to effortlessly build and deploy your own APIs

Eve is Simple

from eve import Eve

app = Eve()
app.run()

The API is now live, ready to be consumed:

$ curl -i http://example.com/people/
HTTP/1.1 200 OK

All you need to bring your API online is a database, a configuration file (defaults to settings.py) and a launch script. Overall, you will find that configuring and fine-tuning your API is a very simple process.

Eve is thoroughly tested under Python 2.6, Python 2.7 and Python 3.3.

Features

Emphasis on REST
Full range of CRUD operations
Customizable resource endpoints
Customizable, multiple item endpoints
Filtering and Sorting
Pagination
HATEOAS
JSON and XML Rendering
Conditional Requests
Data Integrity and Concurrency Control
Multiple Insertions
Data Validation
Extensible Data Validation
Resource-level Cache Control
Versioning
CORS Cross-Origin Resource Sharing
Read-only by default
Default Values
Predefined Database Filters
Projections
Event Hooks
Native MongoDB Support
SQL Alchemy Support (WIP)
Powered by Flask

Wednesday, July 31, 2013

Why REST is so important

http://babdev.blogspot.co.at/2013/07/why-rest-is-so-important.html

This post is dedicated to REST, an architectural style of shaping webservices and the most misunderstood concept in the history of IT. This post is addressed to you who is designing webservice apis not being fully aware what REST actually means.

The meaning of REST

Why RPC is a pain in the A**

But SOAP is still bad

Sessions are Evil

Dont reinvent Hypermedia

Further Resources

In this post, i have only scratched the surface of the advantages of REST.
Here are some good resources to get you a deeper understanding.

Posted by

http://babdev.blogspot.co.at/2013/07/why-rest-is-so-important.html