# REST

## Internal Links

+ [Frameworks](/technology/softwareArchitecture/rest/frameworks)
+ [Ideology And Rants](/technology/softwareArchitecture/rest/ideologyAndRants)
+ [Security](/technology/softwareArchitecture/rest/security)
+ [Toolchain](/technology/softwareArchitecture/rest/toolchain)

## External Links

+ General Information
    + [REST Chapter from "Architectural Styles and the Design of Network-based Software Architectures"](http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)
    + [HTTP/1.1 Specification](http://www.w3.org/Protocols/rfc2616/rfc2616.html)
    + [How I Explained REST to My Wife](http://tomayko.com/writings/rest-to-my-wife)
    + [Implementing REST Wiki on Google Code](http://code.google.com/p/implementing-rest/)
    + [Richardson Maturity Model](http://martinfowler.com/articles/richardsonMaturityModel.html) by Martin Fowler
    + [StackOverflow: Examples of the best SOAP/REST/RPC web APIs?](http://stackoverflow.com/questions/409338/examples-of-the-best-soap-rest-rpc-web-apis-and-why-do-you-like-them-and-what)
    + [How Should REST Services be Documented?](http://java.dzone.com/articles/how-should-rest-services-be)
    + [Restful Web-Services Best Practices](http://soa.dzone.com/articles/restful-web-services-best)
    + [Video: RESTful API Design: Second Edition Webinar](http://blog.apigee.com/detail/slides_for_restful_api_design_second_edition_webinar/)
        + [first part](http://blog.apigee.com/detail/restful_api_design/)
    + [Video: Designing a Beautiful REST+JSON API](http://youtu.be/5WXYw4J4QOU)
        + [Slides](http://de.slideshare.net/stormpath/rest-jsonapis)
    + [Great Series on REST and Resource-Oriented Architecture](http://www.mkbergman.com/482/great-series-on-rest-and-resource-oriented-architecture/)
    + [Resource-Oriented Architecture: The Rest of REST](http://www.infoq.com/articles/roa-rest-of-rest)
    + [Resource-Oriented Architecture: Resource Metadata](http://www.infoq.com/articles/roa-resource-metadata)
    + [Best Practices for Designing a Pragmatic RESTful API](http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api)
+ Protocols and Specifications
    + [Hypermedia JSON Browser](https://bitbucket.org/ratfactor/hm-json-browser/wiki/Home) is a JavaScript client that can browse and interact with hm-json (Hypermedia JSON) APIs. It is intended to: 1. Show that JSON can be hypermedia, and 2. Make discovering and using an API as easy as surfing the Web.
    + [HAL - Hypertext Application Language](http://stateless.co/hal_specification.html) is a format you can use in your API that gives you a simple way of linking.
        + [JSON Linking with HAL](http://blog.stateless.co/post/13296666138/json-linking-with-hal)
        + [HALbert](https://github.com/xcambar/halbert)
        + [Haltalk](http://haltalk.herokuapp.com/explorer/browser.html)
    + [Collection+JSON](http://amundsen.com/media-types/collection/)
    + [Siren](https://github.com/kevinswiber/siren)
    + [Webhooks, REST and the Open Web](http://apiux.com/2013/09/12/webhooks/)
        + [pubsubhubbub](https://code.google.com/p/pubsubhubbub/)
    + [Google APIs Dsicovery Service](https://developers.google.com/discovery/)
+ Documentation
    + [Describing RESTful Applications](http://www.infoq.com/articles/subbu-allamaraju-rest)
    + [SPORE](https://github.com/SPORE/specifications/blob/master/spore_description.pod) (Specifications to a Portable REST Environment) Description Implementation.
    + [Swagger](http://swagger.wordnik.com/) is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services.
        + [SwaggerSocket](http://blog.wordnik.com/introducing-swaggersocket-a-rest-over-websocket-protocol): A REST over WebSocket Protocol
        + [hapi-swagger](https://github.com/glennjones/hapi-swagger)
    + [apiary.io](http://apiary.io/)
    + [ApiDoc](http://apidocjs.com/)
    + [JSONAPI.org](http://jsonapi.org/)