commit 58cd07c1b638bd6773a9940547b3b0f291d145e7 Author: Jonathan Petitcolas Date: Thu May 7 10:22:20 2015 +0200 Add first REST friendly links diff --git a/README.md b/README.md new file mode 100644 index 0000000..44c1bfd --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +# Awesome REST + +This is a link repository centralizing resources, tools and frameworks about REST architecture. Feel free to contribute to this ongoing list. + +## REST normalization + +* [RAML](http://raml.org/): a simple and succinct way to describe RESTful API +* [Haters gonna HATEOAS](http://timelessrepo.com/haters-gonna-hateoas): a clear explanation on what HATEOAS is, and why you should use it. + +## Design + +* [How to design a REST API?](http://blog.octo.com/en/design-a-rest-api/): a full guide tackling security, pagination, filtering, versioning, partial answers, CORS, etc. + +## Building a REST API + +### Node.js + +* [json-server](https://github.com/typicode/json-server): serve a REST API from fixture files using quick prototyping + +### PHP + +* [phprest](https://github.com/phprest/phprest): specialized REST microframework for PHP +* [Hateoas](https://github.com/willdurand/Hateoas): a PHP library to support implementing representations for HATEOAS REST web services + +#### Symfony2 + +* [REST APIs with Symfony2: the Right Way](http://williamdurand.fr/2012/08/02/rest-apis-with-symfony2-the-right-way/): a complete guide to build a state-of-the-art REST API with Symfony2 framework +* [FOSRestBundle](https://github.com/FriendsOfSymfony/FOSRestBundle): bundle handling view, routing, error handling, etc. for your REST API +* [stanlemon/rest-bundle](https://github.com/stanlemon/rest-bundle): build a REST API based on Doctrine entities using conventions over configuration +* [Lionframe](http://lakion.com/lionframe): a glu between several community libraries to ease API development +* [BazingaHateoasBundle](https://github.com/willdurand/BazingaHateoasBundle): integrate the [Hateoas](https://github.com/willdurand/Hateoas) library into a Symfony2 application +* [Symfony REST Edition](https://github.com/gimler/symfony-rest-edition): start with a Symfony2 application with all REST-friendly bundles pre-configured + +### Go + +* [go-json-rest](https://github.com/ant0ine/go-json-rest): a thin layer on top of `net/http` that helps building RESTful API easily + +## REST based-tools + +* [postgrest](https://github.com/begriffs/postgrest): serve a fully RESTful API directly from an existing PSQL database +* [ng-admin](https://github.com/marmelab/ng-admin): add an AngularJS admin GUI to any RESTful API \ No newline at end of file