Survey of Semantic Description of REST APIs

  • Ruben Verborgh
  • Andreas Harth
  • Maria Maleshkova
  • Steffen Stadtmüller
  • Thomas Steiner
  • Mohsen Taheriyan
  • Rik Van de Walle

Abstract

The REST architectural style assumes that client and server form a contract with content negotiation, not only on the data format but implicitly also on the semantics of the communicated data, i.e., an agreement on how the data have to be interpreted [247]. In different application scenarios such an agreement requires vendor-specific content types for the individual services to convey the meaning of the communicated data. The idea behind vendor-specific content types is that service providers can reuse content types and service consumers can make use of specific processors for the individual content types. In practice however, we see that many RESTful APIs on the Web simply make use of standard non-specific content types, e.g., text/xml or application/json [150]. Since the agreement on the semantics is only implicit, programmers developing client applications have to manually gain a deep understanding of several APIs from multiple providers.

Copyright information

© Springer Science+Business Media New York 2014

Authors and Affiliations

  • Ruben Verborgh
    • 1
  • Andreas Harth
    • 2
  • Maria Maleshkova
    • 2
  • Steffen Stadtmüller
    • 2
  • Thomas Steiner
    • 3
  • Mohsen Taheriyan
    • 4
  • Rik Van de Walle
    • 5
  1. 1.Multimedia Lab – Ghent University – iMindsLedeberg-GhentBelgium
  2. 2.Institute AIFBKarlsruhe Institute of Technology (KIT)KarlsruheGermany
  3. 3.Departament de Llenguatges i Sistemes InformaticsUniversitat Politècnica de CatalunyaBarcelonaSpain
  4. 4.Information Science InstituteUniversity of Southern CaliforniaMarina del ReyUSA
  5. 5.Multimedia Lab – Ghent University – iMindsLedeberg- GhentBelgium

Personalised recommendations