Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services
Abstract Web services are provided with documents that at the very least specify the endpoint, input parameters, and output or response of each operation to expose their capabilities. This should be considered through an understandable format for humans and/or machines. In the Representational State...
| Main Authors: | , , |
|---|---|
| Format: | Article |
| Language: | English |
| Published: |
SpringerOpen
2022-04-01
|
| Series: | Journal of Big Data |
| Subjects: | |
| Online Access: | https://doi.org/10.1186/s40537-022-00600-8 |
| _version_ | 1818009940864794624 |
|---|---|
| author | Wardani Muhamad Suhardi Yoanes Bandung |
| author_facet | Wardani Muhamad Suhardi Yoanes Bandung |
| author_sort | Wardani Muhamad |
| collection | DOAJ |
| description | Abstract Web services are provided with documents that at the very least specify the endpoint, input parameters, and output or response of each operation to expose their capabilities. This should be considered through an understandable format for humans and/or machines. In the Representational State Transfer (REST) architectural style, the OpenAPI Specification (OAS) is used as a reference to create web service descriptions. However, it only supports syntactic interoperability, leading to the incapability of supporting the automated selection process. To overcome this, OAS documents must be enhanced by including semantics to each resource to provide “understandable” services. Therefore, this study aims to develop a system capable of transforming resources in OAS documents into RDF-based semantic web services. To begin, a relational database schema based on the OAS structure is created to store all objects in the OAS document. The published open-linked vocabulary was then used to create the ontology, which maps resources and their relationships on the RDF data model. To build RDF-based semantic web services, R2RML was used to generate the relational database model into triple RDF. The proposed system was also tested through prototyping and using a dataset of 106 OAS documents, which were downloaded from APIs.guru between 5–10 May 2021. The number of triple RDFs generated per document varied with resource rate. An OAS document generates 36 to 16,505 triple RDF in a dataset. The end product was a triple RDF knowledge base maintained by a graph management database. It is now possible to find service operations, input and output parameters, and service composition requirements utilizing the repository semantic web services using SPARQL. On the other hand, the use of relational databases to store OAS resources increased reuse efficiency by approximately 48%, owing to service developers designing interoperability between uniform parameter services, which were then used as input and output. |
| first_indexed | 2024-04-14T05:49:12Z |
| format | Article |
| id | doaj.art-2201a61a906e4903a4fa3ced01321b41 |
| institution | Directory Open Access Journal |
| issn | 2196-1115 |
| language | English |
| last_indexed | 2024-04-14T05:49:12Z |
| publishDate | 2022-04-01 |
| publisher | SpringerOpen |
| record_format | Article |
| series | Journal of Big Data |
| spelling | doaj.art-2201a61a906e4903a4fa3ced01321b412022-12-22T02:09:11ZengSpringerOpenJournal of Big Data2196-11152022-04-019112410.1186/s40537-022-00600-8Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web servicesWardani Muhamad0Suhardi1Yoanes Bandung2School of Electrical Engineering and Informatics, Institut Teknologi BandungSchool of Electrical Engineering and Informatics, Institut Teknologi BandungSchool of Electrical Engineering and Informatics, Institut Teknologi BandungAbstract Web services are provided with documents that at the very least specify the endpoint, input parameters, and output or response of each operation to expose their capabilities. This should be considered through an understandable format for humans and/or machines. In the Representational State Transfer (REST) architectural style, the OpenAPI Specification (OAS) is used as a reference to create web service descriptions. However, it only supports syntactic interoperability, leading to the incapability of supporting the automated selection process. To overcome this, OAS documents must be enhanced by including semantics to each resource to provide “understandable” services. Therefore, this study aims to develop a system capable of transforming resources in OAS documents into RDF-based semantic web services. To begin, a relational database schema based on the OAS structure is created to store all objects in the OAS document. The published open-linked vocabulary was then used to create the ontology, which maps resources and their relationships on the RDF data model. To build RDF-based semantic web services, R2RML was used to generate the relational database model into triple RDF. The proposed system was also tested through prototyping and using a dataset of 106 OAS documents, which were downloaded from APIs.guru between 5–10 May 2021. The number of triple RDFs generated per document varied with resource rate. An OAS document generates 36 to 16,505 triple RDF in a dataset. The end product was a triple RDF knowledge base maintained by a graph management database. It is now possible to find service operations, input and output parameters, and service composition requirements utilizing the repository semantic web services using SPARQL. On the other hand, the use of relational databases to store OAS resources increased reuse efficiency by approximately 48%, owing to service developers designing interoperability between uniform parameter services, which were then used as input and output.https://doi.org/10.1186/s40537-022-00600-8Service compositionSemantic web servicesRDFOpenAPI SpecificationSemantic ontology |
| spellingShingle | Wardani Muhamad Suhardi Yoanes Bandung Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services Journal of Big Data Service composition Semantic web services RDF OpenAPI Specification Semantic ontology |
| title | Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services |
| title_full | Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services |
| title_fullStr | Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services |
| title_full_unstemmed | Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services |
| title_short | Transforming OpenAPI Specification 3.0 documents into RDF-based semantic web services |
| title_sort | transforming openapi specification 3 0 documents into rdf based semantic web services |
| topic | Service composition Semantic web services RDF OpenAPI Specification Semantic ontology |
| url | https://doi.org/10.1186/s40537-022-00600-8 |
| work_keys_str_mv | AT wardanimuhamad transformingopenapispecification30documentsintordfbasedsemanticwebservices AT suhardi transformingopenapispecification30documentsintordfbasedsemanticwebservices AT yoanesbandung transformingopenapispecification30documentsintordfbasedsemanticwebservices |