Toward Automatic Semantic API Descriptions to Support Services Composition

Conference paper
Part of the Lecture Notes in Computer Science book series (LNCS, volume 10465)


The ability to provide appropriate and complete API descriptions to let users discover services that satisfy a set of requirements and compose them to fulfil more complex users’ needs is critical for the success of any modern ICT solution. Composition suffers from the lack of semantic matching between properties included in published API descriptions. The work presented in this paper addresses this issue by discussing the current formats and tools to build API descriptions, and presenting a method for extracting and associating semantic to properties. Such method relies on a revised version of Table Interpretation techniques to support semantic annotations of API properties. The objectives are to enrich the popular OpenAPI Specification format with semantic annotations, and add the functionality of semantic annotation and composition to the associated editor.


  1. 1.
    Adida, B., Birbeck, M., McCarron, S., Pemberton, S.: RDFa in XHTML: syntax and processing. Recommendation W3C, 7 (2008)Google Scholar
  2. 2.
    Brickley, D., Guha, R.V., McBride, B.: RDF schema 1.1. W3C recommendation 25, 2004–2014 (2014)Google Scholar
  3. 3.
    Chinnici, R., Moreau, J.J., Ryman, A., Weerawarana, S.: Web services description language (WSDL) version 2.0 part 1: core language. W3C recommendation 26, 19 (2007)Google Scholar
  4. 4.
    Chowdhury, G.G.: Natural language processing. Annu. Rev. Inf. Sci. Technol. 37(1), 51–89 (2003)MathSciNetCrossRefGoogle Scholar
  5. 5.
    Gomadam, K., Ranabahu, A., Sheth, A.: SA-REST: semantic annotation of web resources. W3C Member Submiss. 5, 52 (2010)Google Scholar
  6. 6.
    Hadley, M.J.: Web Application Description Language (WADL). Technical report, Mountain View, CA, USA (2006)Google Scholar
  7. 7.
    Kopeckỳ, J., Vitvar, T., Fensel, D., Gomadam, K.: hRESTS and MicroWSMO. Technical report, STI International (2009)Google Scholar
  8. 8.
    Lausen, H., Farrell, J.: Semantic annotations for WSDL and XML schema. W3C recommendation, W3C, p. 69 (2007)Google Scholar
  9. 9.
    Li, P., Comerio, M., Maurino, A., De Paoli, F.: An approach to non-functional property evaluation of web services. In: Proceedings of IEEE International Conference on Web Services, ICWS 2009, pp. 1004–1005 (2009)Google Scholar
  10. 10.
    Lucky, M.N., Cremaschi, M., Lodigiani, B., Menolascina, A., De Paoli, F.: Enriching API descriptions by adding API profiles through semantic annotation. In: Sheng, Q.Z., Stroulia, E., Tata, S., Bhiri, S. (eds.) ICSOC 2016. LNCS, vol. 9936, pp. 780–794. Springer, Cham (2016). doi: 10.1007/978-3-319-46295-0_55
  11. 11.
    Martin, D., Burstein, M., Hobbs, J., Lassila, O., McDermott, D., McIlraith, S., Narayanan, S., Paolucci, M., Parsia, B., Payne, T., et al.: OWL-S: semantic markup for web services. W3C member submission 22, 2007–04 (2004)Google Scholar
  12. 12.
    Ramnandan, S.K., Mittal, A., Knoblock, C.A., Szekely, P.: Assigning semantic labels to data sources. In: Gandon, F., Sabou, M., Sack, H., d’Amato, C., Cudré-Mauroux, P., Zimmermann, A. (eds.) ESWC 2015. LNCS, vol. 9088, pp. 403–417. Springer, Cham (2015). doi: 10.1007/978-3-319-18818-8_25
  13. 13.
    Roman, D., Kopeckỳ, J., Vitvar, T., Domingue, J., Fensel, D.: WSMO-Lite and hRESTS: lightweight semantic annotations for web services and RESTful APIs. Web Semant. Sci. Serv. Agents World Wide Web 31, 39–58 (2015)CrossRefGoogle Scholar
  14. 14.
    Sheng, Q.Z., Qiao, X., Vasilakos, A.V., Szabo, C., Bourne, S., Xu, X.: Web services composition: a decades overview. Inf. Sci. 280, 218–238 (2014)CrossRefGoogle Scholar
  15. 15.
    Tsouroplis, R., Petychakis, M., Alvertis, I., Biliri, E., Lampathaki, F., Askounis, D.: Community-based API builder to manage APIs and their connections with cloud-based services. In: CAiSE Forum (2015)Google Scholar
  16. 16.
    Verborgh, R., Harth, A., Maleshkova, M., Stadtmüller, S., Steiner, T., Taheriyan, M., Van de Walle, R.: Survey of semantic description of rest APIs. In: Pautasso, C., Wilde, E., Alarcon, R. (eds.) REST: Advanced Research Topics and Practical Applications, pp. 69–89. Springer, New York (2014). doi: 10.1007/978-1-4614-9299-3_5 CrossRefGoogle Scholar
  17. 17.
    Verborgh, R., Mannnens, E., Van de Walle, R.: Bottom-up web APIs with self-descriptive responses. In: Proceedings of the First Karlsruhe Service Summit Workshop-Advances in Service Research, p. 143. KIT Scientific Publishing (2015)Google Scholar
  18. 18.
    Zhang, Z.: Start small, build complete: effective and efficient semantic table interpretation using tableminer. Under Transparent Rev. Seman. Web J. (2014)Google Scholar

Copyright information

© IFIP International Federation for Information Processing 2017

Authors and Affiliations

  1. 1.Department of Informatics, Systems and CommunicationUniversity of Milan - BicoccaMilanItaly

Personalised recommendations