loading
Papers Papers/2022 Papers Papers/2022

Research.Publish.Connect.

Paper

Paper Unlock

Authors: Jéssica Soares Dos Santos ; Leonardo Guerreiro Azevedo ; Elton F. S. Soares ; Raphael M. Thiago and Viviane T. Silva

Affiliation: IBM Research, Pasteur Ave, 146, Rio de Janeiro, Brazil

Keyword(s): REST Services, REST Contracts, REST APIs, Swagger, OpenAPI.

Abstract: REST is a resource-based architectural style that has emerged as a promising way for designing Web services. A REST API exposes services’ functionalities through a contract that allows consumption by different clients. The contract specifies service’s request and response schemes and related rules the service and the client should comply with. The process of documenting and keeping an API consistent is a time consuming human effort. The documentation should reflect the implementation which may evolve. This work compares different tools for REST APIs specifications. We focused on tools that automatically generate Swagger (Open API in version 3.0), a specification for designing REST APIs. We evaluated the tools using a set of criteria whose results may help software engineers to choose the most appropriate tool, and point out gaps for research initiatives.

CC BY-NC-ND 4.0

Sign In Guest: Register as new SciTePress user now for free.

Sign In SciTePress user: please login.

PDF ImageMy Papers

You are not signed in, therefore limits apply to your IP address 3.90.33.254

In the current month:
Recent papers: 100 available of 100 total
2+ years older papers: 200 available of 200 total

Paper citation in several formats:
Santos, J.; Azevedo, L.; Soares, E.; Thiago, R. and Silva, V. (2020). Analysis of Tools for REST Contract Specification in Swagger/OpenAPI. In Proceedings of the 22nd International Conference on Enterprise Information Systems - Volume 2: ICEIS; ISBN 978-989-758-423-7; ISSN 2184-4992, SciTePress, pages 201-208. DOI: 10.5220/0009381202010208

@conference{iceis20,
author={Jéssica Soares Dos Santos. and Leonardo Guerreiro Azevedo. and Elton F. S. Soares. and Raphael M. Thiago. and Viviane T. Silva.},
title={Analysis of Tools for REST Contract Specification in Swagger/OpenAPI},
booktitle={Proceedings of the 22nd International Conference on Enterprise Information Systems - Volume 2: ICEIS},
year={2020},
pages={201-208},
publisher={SciTePress},
organization={INSTICC},
doi={10.5220/0009381202010208},
isbn={978-989-758-423-7},
issn={2184-4992},
}

TY - CONF

JO - Proceedings of the 22nd International Conference on Enterprise Information Systems - Volume 2: ICEIS
TI - Analysis of Tools for REST Contract Specification in Swagger/OpenAPI
SN - 978-989-758-423-7
IS - 2184-4992
AU - Santos, J.
AU - Azevedo, L.
AU - Soares, E.
AU - Thiago, R.
AU - Silva, V.
PY - 2020
SP - 201
EP - 208
DO - 10.5220/0009381202010208
PB - SciTePress