Paper Info
Title
Model your application domain, not your JSON structures
Abstract
Creating truly RESTful Web APIs is still more an art than a science. Developers have to struggle with a number of complex design decisions because concrete guidelines and processes are missing. Consequently, often it is decided to implement the simplest solution which is, most of the time, to rely on out-of-band contracts between the client and the server. Instead of properly modeling the application domain, all the effort is put in the design of proprietary JSON structures and URLs. This then forms the base for the contract which is communicated in natural-language (with all its ambiguity) to client developers. Since it is the server who owns the contract it may be changed at any point, which, more often than not, results in broken clients. In this position paper, we discuss some of the challenges and choices that need to be made when designing RESTful Web APIs. In particular, we compare how contracts are supposed to be established and how they are defined in practice. We illustrate the problems that are the cause of these divergences. As a first step to address these issues we describe and motivate an alternative, domain-driven approach to design Web APIs.
Year
DOI
Venue
2013
10.1145/2487788.2488184
WWW (Companion Volume)
Keywords
Field
DocType
application domain,json structure,client developer,position paper,web apis,concrete guideline,domain-driven approach,complex design decision,restful web apis,out-of-band contract,broken client,web,hydra,web services,json ld,rest,http,distributed systems,linked data
Web API,Data mining,World Wide Web,Computer science,Linked data,Web modeling,Application domain,Web 2.0,Web service,JSON,JSON-LD
Conference
ISBN
Citations 
PageRank 
978-1-4503-2038-2
7
0.72
References 
Authors
3
2
Name
Order
Citations
PageRank
Markus Lanthaler110811.34
Christian Gütl222834.68