Propuesta y aplicación de una Guía Técnica para adoptar API-FIRST

Autores/as

DOI:

https://doi.org/10.15649/2346030X.4164

Palabras clave:

API-First, spring boot, open API, guía técnica

Resumen

Una innovación de la industria de las APIs web es el enfoque de desarrollo de software API-First. Según diversos autores en el ámbito académico, aún son escasos los estudios que lo han abordado. Sin embargo, los defensores de este modelo aseguran que genera múltiples beneficios para el desarrollo de software y las empresas. Para lograr un acercamiento al mismo, en este trabajo proponemos una guía técnica para su aplicación, obtenida de su exploración y descripción exhaustiva. Evaluamos y demostramos dicho instrumento en un problema real y local. La guía está fuertemente orientada al uso de tecnologías y herramientas específicas que impactaron en la duración y complejidad de la API desarrollada.

Biografía del autor/a

  • Juan Gabriel Enriquez, Universidad Nacional de la Patagonia Austral - Río Gallegos, Argentina

    Licenciado en Ciencias de la Computación (2003) en la Universidad Nacional del Sur (Bahia Blanca), y Magister en Sistemas e Informática (2016) en la Universidad Nacional de la Patagonia Austral (UNPA). Integrante del Grupo de Investigación de Software Pragmática del ITA-UARG. Participa en distintos proyectos de investigación desde el año 2010. Docente (Profesor Adjunto) de diversas materias en la carrera de Analista de Sistemas y Licenciatura de Sistemas, en la UNPA-UARG.

  • Héctor Reinaga, Universidad Nacional de la Patagonia Austral - Río Gallegos, Argentina

    Licenciado en Sistemas (2003) en la Universidad Nacional de la Patagonia Austral, Unidad Académica Río Gallegos (UNPA-UARG); y Magister en Sistemas e Informática (2023) en UNPA-UARG. Integrante del Grupo de Investigación de Software Pragmática del ITA-UARG. Participa en distintos proyectos de investigación desde el año 2003. Docente (Profesor Adjunto) de diversas materias en la carrera de Analista de Sistemas y Licenciatura de Sistemas, en la UNPA-UARG. Integrante del Comité Asesor de la Escuela de Sistemas e Informática UNPA-UARG.

  • Sandra Isabel Casas, Universidad Nacional de la Patagonia Austral - Río Gallegos, Argentina

    Licenciada en Informática (1992) en la Universidad del Salvador (Buenos Aires), y Doctora en Ingeniera de Software (2008) en la Universidad Vigo (España). Integrante del Grupo de Investigación de Software Pragmática del ITA-UARG. Participa en distintos proyectos de investigación desde el año 2001. Directora de Proyectos de Investigación desde el año 2010. Docente (Profesor Asociado) de diversas materias en la carrera de Analista de Sistemas y Licenciatura de Sistemas, en la UNPA-UARG.

Referencias

[1] L. Richardson, M. Amundsen y S. Ruby, RESTful Web APIs, O'Reilly Media, 2013.

[2] J. M. Rivero, S. Heil y J. Grigera, «MockAPI: An Agile Approach Supporting API-first Web Application Development,» (eds) Web Engineering. ICWE 2013. Lecture Notes in Computer Science. Springer, Berlin, Heidelberg., vol. 7977, pp. 7-21, 2013.

[3] W. Tan, Y. Fan, A. Ghoneim, M. A. Hossain y S. Dustdar, «From the Service-Oriented Architecture to the Web API Economy,» IEEE Internet Computing, vol. 20, nº 4, pp. 64-68, 2016.

[4] N. Beaulieu, S. M. Dascalu y E. Hand, «API-First Design: A Survey of the State of Academia and Industry,» ITNG 2022 19th International Conference on Information Technology-New Generations. Advances in Intelligent Systems and Computing, vol. 1421, pp. 73-79, 2022.

[5] P. (s.f.), «Guide to API-first,» [En línea]. Available: https://www.postman.com/api-first. [Último acceso: 29 11 24].

[6] N. Beaulieu, S. Dascalu y E. Hand, «API Integrator: A UI Design and Code Automation Application Supporting API-First Design,» ACIT '22: Proceedings of the 9th International Conference on Applied Computing & Information Technology, pp. 36-40, 2023.

[7] Postman, «State of the API Report,» 2023. [En línea]. Available: https://www.postman.com/state-of-api/2023/. [Último acceso: 29 11 2023].

[8] J. Lin, «Medium. API-first software development for modern organizations,» 2018. [En línea]. Available: https://medium.com/better-practices/api-first-software-development-for-modern-organizations-fdbfba9a66d3. [Último acceso: 11 09 2023].

[9] L. Trieloff, «Medium. Three Principles of API First Design,» 2017. [En línea]. Available: https://blog.developer.adobe.com/three-principles-of-api-first-design-fa6666d9f694. [Último acceso: 01 09 2023].

[10] O. Hämäläinen, «API-First Design with Modern Tools. Thesis, School of Business, Degree Programme in Business Information Technology,» 2019. [En línea]. Available: https://urn.fi/URN:NBN:fi:amk-2019060615295. [Último acceso: 23 10 2023].

[11] J. Wagner, «Swagger. Plan Your API-First Program,» [En línea]. Available: https://swagger.io/resources/articles/adopting-an-api-first-approach. [Último acceso: 07 09 2023].

[12] API: Addicts (s.f.), «Implementa API-First con las APITools,» [En línea]. Available: https://www.apiaddicts.org/apitools. [Último acceso: 10 10 2023].

[13] K. Lane, The API-First Transformation, Postman Inc., 2022, p. 262.

[14] K. Lane, «APIscene,» [En línea]. Available: https://www.apiscene.io/author/kin-lane. [Último acceso: 29 07 2024].

[15] M. Dudjak y G. Martinovic, «An API-first methodology for designing a microservice-based Backend as a Service platform.,» Information technology and control, vol. 49, nº 2, pp. 206-223, 2020.

[16] J. J. Londoño Tirado, «Gobierno de APIs, implementación y experimentación con API-First y OpenAPI en el proyecto P2P energía transactiva. Trabajo de grado. Universidad de Antioquia,» [En línea]. Available: https://hdl.handle.net/10495/29121. [Último acceso: 20 10 2023].

[17] J. Larsson y L. Åkermark, «The value of implementing API-First as a methodology when developing APIs (Dissertation) - Jonkoping University,» 2021. [En línea]. Available: https://urn.kb.se/resolve?urn=urn:nbn:se:hj:diva-54311. [Último acceso: 26 09 2023].

[18] K. Peffers, T. Tuunanen, M. A. Rothenberger y S. Chatterjee, «A design science research methodology for information systems research.,» Journal of Management Information Systems: JMIS, vol. 24, nº 3, pp. 45-77, 2007.

[19] R. Wieringa y A. Morali, «Technical Action Research as a Validation Method in Information Systems Design Science,» Design Science Research in Information Systems. Advances in Theory and Practice, vol. 7286, pp. 220-238, 2012.

[20] G. Hadad, J. Doorn y G. Kaplan, «Explicitar Requisitos del Software usando Escenarios,» Workshop em Engenharia de Requisitos, 2009.

[21] A. Cleven, P. Gubler y K. M. Hüner, «Design alternatives for the evaluation of design science research artifacts,» International Conference on Design Science Research in Information Systems and Technology, 2009.

Descargas

Publicado

01-09-2025

Cómo citar

[1]
J. G. Enriquez, H. Reinaga, and S. I. Casas, “Propuesta y aplicación de una Guía Técnica para adoptar API-FIRST”, AiBi Revista de Investigación, Administración e Ingeniería, vol. 13, no. 3, pp. 01–11, Sep. 2025, doi: 10.15649/2346030X.4164.

Descargas

Los datos de descarga aún no están disponibles.

Número

Vol. 13 Núm. 3 (2025): Septiembre-Diciembre

Sección

Artículos de Investigación

Licencia

Derechos de autor 2025 AiBi Revista de Investigación, Administración e Ingeniería

Creative Commons License

Esta obra está bajo una licencia internacional Creative Commons Atribución 4.0.

La revista ofrece acceso abierto bajo una Licencia Creative Commons Attibution License

Licencia Creative Commons
Esta obra está bajo una licencia Creative Commons Attribution (CC BY 4.0).

Artículos similares

1-10 de 94

También puede Iniciar una búsqueda de similitud avanzada para este artículo.