awesome-rest/README.md

Awesome REST

Following the awesome-* trend, here is a set of resources related to REST API. Feel free to contribute to this on-going list.

Designing

• Best Practices for Designing a Pragmatic RESTful API
• How to design a REST API?: a full guide tackling security, pagination, filtering, versioning, partial answers, CORS, etc.
• Haters gonna HATEOAS: a clear explanation on what HATEOAS is, and why you should use it.
• RAML: a simple and succinct way to describe RESTful API
• JSON API: a standard for building APIs in JSON

Consuming

PHP

• Guzzle: HTTP client and framework for consuming RESTful web services
• Buzz: another lightweight HTTP client

JavaScript

• restangular: AngularJS service to handle REST API properly and easily
• restful.js: a JS client for interacting with server-side RESTful resources

Ruby

• RESTClient - Simple HTTP and REST client for Ruby, inspired by microframework syntax for specifying actions.
• Spyke - Interact with REST services in an ActiveRecord-like manner.
• excon - Usable, fast, simple Ruby HTTP 1.1. It works great as a general HTTP(s) client and is particularly well suited to usage in API clients.

Go

• gopencils - Small and simple package to easily consume REST APIs.

Building

Node.js

• Baucis: build scalable REST API based on your Mongoose entities
• node-restify: a framework specifically meant for REST API
• mers: an Express service to expose Mongoose finders as RESTful API
• Sails.js: a Node.js Web framework embedding a command to generate automatically a REST API

PHP

• Microrest: a micro-web application providing a REST API on top of any relational database
• Negotiation - A content negotiation library.
• Drest - A library for exposing Doctrine entities as REST resource endpoints.
• Restler - A lightweight framework to expose PHP methods as RESTful web API.
• HAL - A Hypertext Application Language (HAL) builder library.
• Apigility - An API builder built with Zend Framework 2.
• phprest: specialized REST microframework for PHP
• Hateoas: a PHP library to support implementing representations for HATEOAS REST web services

Symfony2

• REST APIs with Symfony2: the Right Way: a complete guide to build a state-of-the-art REST API with Symfony2 framework
• FOSRestBundle: bundle handling view, routing, error handling, etc. for your REST API
• stanlemon/rest-bundle: build a REST API based on Doctrine entities using conventions over configuration
• Lionframe: a glu between several community libraries to ease API development
• BazingaHateoasBundle: integrate the Hateoas library into a Symfony2 application
• Symfony REST Edition: start with a Symfony2 application with all REST-friendly bundles pre-configured
• NgAdminGeneratorBundle: boostrap ng-admin configuration based on stanlemon/rest-bundle

Python

• django-tastypie - Creating delicious APIs for Django apps.
• flask-restful - An extension for Flask that adds support for quickly building REST APIs.
• flask-restless - A Flask extension for generating ReSTful APIs for database models defined with SQLAlchemy (or Flask-SQLAlchemy).
• sandman - Automated REST APIs for existing database-driven systems.
• restless - Framework agnostic REST framework based on lessons learned from TastyPie.
• savory-pie - REST API building library (django, and others)

Ruby

• Grape - An opinionated micro-framework for creating REST-like APIs in Ruby.

Go

• go-json-rest: a thin layer on top of net/http that helps building RESTufmigl API easily
• sleepy: a RESTful micro-framework written in Go
• restit - A Go micro framework to help writing RESTful API integration test
• go-relax - A framework of pluggable components to build RESTful API's
• go-rest - A small and evil REST framework for Go
• Goat - A minimalistic REST API server in Go
• Resoursea - A REST framework for quickly writing resource based services.
• Zerver - Zerver is a expressive, modular, feature completed RESTful framework.

Testing

Querying

• httpie: a command line HTTP client, far more dev-friendly than curl
• Postman REST Client: a Chrome extension essential to test manually REST API
• resty: little command line REST client that you can use in pipelines (bash or zsh)
• jq: command line JSON processor

Mocking

• FakeRest: patch XMLHttpRequest to fake a REST API client-side
• json-server: serve a REST API from fixture files using quick prototyping

REST based-tools

• postgrest: serve a fully RESTful API directly from an existing PSQL database
• ng-admin: add an AngularJS admin GUI to any RESTful API