« Previous 1 2 3 4
Developing RESTful APIs
Late Bloomer
Conclusion
REST is an abstract idea designed to better structure the behavior of a software architecture. The approach demands discipline and requires an additional level of abstraction on top of the desired solution. Not everyone is enamored, and how meaningful this overhead is depends on the API's intended use. How long do the developers intend to maintain it? How quickly do you want to be able to introduce it to new developers? How compatible should it be with other solutions? These are just a few of the fundamental issues.
The sample API on the Sinatra server is designed to illustrate the abstraction. To create a full RESTful API, developers would need to elaborate the RAML design and make a sensible choice for the data format standard.
The advantage of REST is the concept of the "Hypertext As The Engine Of Application State" (HATEOAS). Roughly this means that, based on the existing hypertext, any client should know the current application state and be able to enter the next state via the hypertext mechanisms.
The sample does not implement this concept in a satisfactory way. The client can tell from the response how to access a single contact, but it does not learn how to create it or how to structure the data to do so. The next step would be to integrate this information into the format itself.
Some standard formats offer to add POST templates or schema descriptions to the protocol. It makes a lot of sense to look at the registered formats and protocols such as IANA [6], Schema.org [7], and Alps.io [8].
Infos
- Request for Comments 707. A High-Level Framework for Network-Based Resource Sharing: https://tools.ietf.org/html/rfc707
- Fielding, Roy T. Architectural Styles and the Design of Network-Based Software Architectures . PhD dissertation, University of California, 2000, http://roy.gbiv.com/pubs/dissertation/top.htm
- Request for Comments 7231. Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content: https://tools.ietf.org/html/rfc7231
- Richardsen, Lennard and Mike Amundsen. RESTful Web APIs: Services for a Changing World . O'Reilly, 2013
- Amundsen, Mike. Building Hypermedia APIs with HTML5 & Node – Creating Evolvable Hypermedia Applications . O'Reilly, 2011
- Media types registered with IANA: https://www.iana.org/assignments/media-types/media-types.xhtml
- Schemas for structured data on the Internet: http://schema.org
- Application-Level Profile Semantics (ALPS): http://alps.io/spec/index.html
- OData standard by OASIS: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata
- Request for Comments 5023. The Atom Publishing Protocol: https://tools.ietf.org/html/rfc5023
- JavaScript Object Notation (JSON): http://www.json.org
- OData Standard, Part 1, Core (ISO/IEC 20802-1:2016): https://www.iso.org/standard/69208.html
- OData Standard, Part 2, OData JSON Format (ISO/IEC 20802-2:2016): https://www.iso.org/standard/69209.html
- Open API Initiative: https://www.openapis.org
- "Swagger API" by Tim Schürmann, Linux Pro Magazine , issue 34, 2016, pg. 52, http://www.admin-magazine.com/Archive/2016/34/Swagger-and-OpenAPI-Specification-for-documents
- OpenAPI specification: https://github.com/OAI/OpenAPI-Specification
- Swagger tools: http://swagger.io/open-source-integrations/
- Swagger Petstore: http://petstore.swagger.io
- RAML: http://raml.org
- RAML v0.8: https://github.com/raml-org/raml-spec/blob/master/versions/raml-08/raml-08.md
- MuleSoft API Designer: https://www.mulesoft.com/platform/api/anypoint-designer
- MuleSoft API Workbench: http://apiworkbench.com
- RAML 100 Tutorial: http://raml.org/developers/raml-100-tutorial
The Author
Marcus Nasarek has focused on Linux for many years and is a huge fan of scripting, Ruby, and Raspberry Pi projects.
« Previous 1 2 3 4
Buy this article as PDF
(incl. VAT)
Buy ADMIN Magazine
US / Canada
UK / Australia
Related content
-
Haskell framework for the web
The Yesod web framework includes a Haskell compiler on top of the standard web technologies, such as HTML, JavaScript, and CSS, with aggressive optimization and function checks for correctness. -
Single sign-on like the big guys
Keycloak is a robust and mature project that provides a modern single sign-on authorization experience and centralized authentication of your apps. -
Swagger and OpenAPI Specification for documents
A REST API is especially useful for a developer if the API provider extensively documents the methods used. The Swagger tools not only semiautomatically generate an API reference, but a matching client SDK for many programming languages, as well. -
Open source customer relationship management software
SuiteCRM 7 is a powerful open source enterprise customer relationship management solution. -
Run your own chat server
The Matrix open standard implements secure, decentralized communication and comes with bridges to popular chat apps.
Subscribe to our ADMIN Newsletters
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Most Popular
Support Our Work
ADMIN content is made possible with support from readers like you. Please consider contributing when you've found an article to be beneficial.
