HTTP API Specs

HTTP API Specs: "A collection of RFCs and other specifications, useful when designing and implementing HTTP APIs."

HTTP	Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
Links	Web Linking
Links	URI Template
Links	IANA Link Relation registry
Generic Media Types	JSON Hypertext Application Language
Generic Media Types	Siren
Generic Media Types	Collection+JSON
Other Media Types	Problem Details for HTTP APIs
Other Media Types	Home Documents for HTTP APIs
Semantics	The ‘profile’ Link Relation Type
Negotiation	Prefer Header for HTTP
Caching	HTTP Cache-Control Extensions for Stale Content
Security	Hypertext Transfer Protocol (HTTP/1.1): Authentication
Security	The OAuth 2.0 Authorization Framework
Security	The OAuth 2.0 Authorization Framework: Bearer Token Usage
Security	OpenID Connect Core 1.0
Security	IANA HTTP Authentication Schemes registry
Syntax	Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing
Syntax	Uniform Resource Identifier (URI): Generic Syntax

'via Blog this'

JAX-RS 2.0 : Server side Processing Pipeline | Thinking in Java EE (at least trying to!)

JAX-RS 2.0 : Server side Processing Pipeline | Thinking in Java EE (at least trying to!): "The inspiration for this post was the Processing Pipeline section in the JAX-RS 2.0 specification doc (Appendix C). I like it because of the fact that it provides a nice snapshot of all the modules in JAX-RS – in the form of a ready to gulp capsule !"



'via Blog this'

REST and Web Services links

How to design a REST API

http://blog.octo.com/wp-content/uploads/2014/12/OCTO-Refcard_API_Design_EN_3.0.pdf

Best Practices for Designing a Pragmatic RESTful API

 Good article on #SOA and #REST alignment http://t.co/OJutT8AiKS

Web Application Description Language


REST API Documentation Using JAXRS-ANALYZER


SWAGGER The World's Most Popular Framework for APIs

The Swagger framework addresses server, client, documentation, and sandbox needs for RESTful APIs.^{[citation needed]}

As a specification, it is language-agnostic. It is also extensible into new technologies and protocols beyond HTTP.^{[citation needed]}

With Swagger's declarative resource specification, clients can understand and consume services without knowledge of server implementation or access to the server code.^{[citation needed]}

The Swagger UI framework allows both developers and non-developers to interact with the API in a sandbox UI that gives clear insight into how the API responds to parameters and options. Swagger may utilize both JSON and XML.

Software Architecture links

Ben Morris: What role do architects have in agile development?

Enter the “master developer”

In this case, some kind of design authority is generally required to work across the teams to ensure the integrity of the overall system and spot issues before they become obstacles. This role shouldn’t be confused with governance, where design edicts are sent down to teams from the “ivory towers” and architecture boards. It can only be effective with the consent of the teams.