GitHub "Yelp".
- GitHub "Yelp/bravado", ReadTheDocs "bravado" - “Bravado is a python client library for Swagger 2.0 services”.
Experts told me in 2016-09, that there is still no support for Swagger 2.0 with the Python application framework “Django” .
For calling network functions, the code implementation makes use of Python Decorators.

The old Python Library for Swagger 1.2

Swagger UI

Swagger UI - “A dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API”.

Resources

I was told by experts that Swagger is driven by YAML & JSON.
EuroPython 2016 "Building Service interfaces with OpenAPI / Swagger".
- Video YouTube "Stephan Jaensch - Building Service interfaces with OpenAPI / Swagger".
EN.Wikipedia "OpenAPI Specification".

RAML - RESTful API Modeling Language

RAML - RESTful API Modeling Language.
- RealPython Blog "Create a REST API in Minutes With Pyramid and Ramses" - “We wanted to get rid of all boilerplate though, including the database queries that would normally need to be written for views”.
  - Pyramid - See Python 1/7.
  - GitHub "brandicted/ramses" - “Generate a RESTful API for Pyramid using RAML”.
RAML is built on broadly-used standards such as YAML and JSON and is a non-proprietary, vendor-neutral open spec.
YAML: See Testing.

Some other Software Frameworks based on REST

EN.Wikipedia "Java API for RESTful Web Services", DE.Wikipedia "Java API for RESTful Web Services".
Google Data APIs - “A REST-inspired technology for reading, writing, and modifying information on the web”.
JAX-RS.
- Java.net "GlassFish >> JSR 311".
  - EN.Wikipedia "Java API for RESTful Web Services", EN.Wikipedia "Java API for RESTful Web Services".
- Apache CXF.
  - Apache CXF - Documentation "JAX-RS".
  - EN.Wikipedia "Apache CXF", EN.Wikipedia "Apache CXF".
Restlet - RESTful web framework for Java.
RestSharp - Simple REST and HTTP API Client for NET, Github "RestSharp".
SourceForge "Give it a REST. Play with our RESTful database interface with our interactive REST tutorial", SourceForge "RESTful interface to MySQL using PHP".
Srikanth Technologies - Where Quality Matters "A RESTFul Web Service in Java and Client in JavaScript".

Services and Service Concepts based on REST

Use of PATCH

REST Experts say: PUT has real-world problems!

Entry point

OPTIONS * HTTP/1.1.
rel=“service”.

Representations of a resource are distict

Also: collections and items.

Use of hypermedia: Links and Relations

HTML anchors, XML XLink, Link header.
Less “Web 2.0”, more “HTML 2.0”.

Use of ETag

Experts advise: Check cacheability with REDbot.

Spec References IANA for Media Types and Relations

HTML, AtomPub, hal+json.
Standard types where possible, extensible types where not (microformats, RDFa, profile=$URI in HTML4).
Standard relations where possible, or else mint your own (IANA).

Client side URI Construction

HTML forms, XForms, URI Templates.

Red Pill / blue Pill

“s/REST/HTTP/”.
or: follow the constraints properly.

Services and Service Concepts not based on REST

Services defined by URIs

Services defined by WADL, SPORE

Custom, in-band authentication

Client certificates, X-WSSE.

Web 2.0 company, likely to be featured on Hackerne.ws

Comment by a REST expert: “GData is a tragedy”?!

Use of sessions

Cookies.
Must be able to bookmark a resource.

Services and Service Concepts not based on REST, or not

Lists HTTP status code

Depends!!

Collaboration of Software Frameworks with REST Communications

SourceForge "DIY Framework", SourceForge "DIY Framework" - “An open-source web application framework based on object-oriented PHP 5, MySQL, and XSLT. Designed following MVC architecture and REST principles”.
Spring → See Java & Java Platform Languages.
Oliver Gierke - Expert for Spring with REST.
- Twitter "Oliver Gierke".

Documentation

REST

Videos

YouTube Playlist "Developing RESTful APIs with JAX-RS".

Literature

The book Subbu Allamaraju "RESTful Web Services Cookbook".
Roy Fielding.
- The dissertation Roy Fielding "Architectural Styles and the Design of Network-based Software Architectures"
- EN.Wikipedia "Roy Fielding", DE.Wikipedia "Roy Fielding".
The book Jerome Louvel, Thierry Templier, Thierry Boileau: "Restlet in Action".
The book Leonard Richardson, Sam Ruby "RESTful Web Services".
- EN.Wikipedia "Sam Ruby".
- Blog Sam Ruby, intertwingly.
  - Sam Ruby, intertwingly "REST vs API".
The book Stefan Tilkov: "REST und HTTP: Einsatz der Architektur des Web für Integrationsszenarien" #.
The book Jim Webber, Savas Parastatidis, Ian Robinson "REST in Practice: Hypermedia and Systems Architecture".
- The accompanying website REST in Practice.
The book Erik Wilde, Cesare Pautasso "REST: From Research to Practice".

Open Data Protocol ( OData )

Hardware with REST Software Interface

Wiki Janitza Dashboard.
- Janitza REST API.

Best Practices and Awareness with REST

You must not implement all REST functions for every REST URI!
REST has nothing to do with UI design .
Design goal:
- One-time distribution of applications ( think of the Apple / Android / Windows AppStores, where you can´t provide high-frequent updates due to the complicated long-term acceptance process ).
Typical Process:
1. Just provide one single “stable” webservice URL to the application.
2. The web server returns a Json representation with links.
3. Let the application find all other links by this representation, using a “Link Discoverer”.
  - Use Link relation instead of “hardcoded links”. Explain these links relations ( “Rels” ) by other URL links, to web pages which explain hwo to deal with the data.
4. Poll the webservice by checking the HTML ETags for data changes.