Gestión Continua de APIs, 2ª Edición

Prefacio

Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: [e-mail]

Bienvenido a la segunda edición de la Gestión Continua de APIs. El párrafo inicial de la edición anterior, publicada en 2018, decía:

A medida que la sociedad y las empresas han ido adquiriendo un carácter cada vez más digital, se ha disparado la demanda de software conectado. A su vez, la interfaz de programación de aplicaciones (API) ha surgido como un recurso importante para las organizaciones modernas porque facilita las conexiones de software. Pero la gestión eficaz de estas API ha resultado ser un nuevo reto. Sacar el máximo partido a tus API significa aprender a gestionar su diseño, desarrollo, implementación, crecimiento, calidad y seguridad, al tiempo que te enfrentas a los complicados factores del contexto, el tiempo y la escala.

Y, en los años transcurridos, no han cambiado mucho el crecimiento y los retos de la gestión de las API. La buena noticia es que, en los años transcurridos desde nuestra primera edición, más herramientas, más formación y más experiencia han ayudado a crecer y madurar el espacio de la gestión de API. La noticia no tan buena es que los autores siguen viendo que muchas organizaciones luchan por satisfacer las demandas de conectar personas, servicios y empresas mediante API. Esta nueva edición es nuestra oportunidad de proporcionar información actualizada sobre cómo están progresando las empresas, compartir algunas nuevas historias de éxito y perfeccionar parte del material que presentamos por primera vez en 2018.

Aunque hemos añadido nuevos ejemplos y actualizado los existentes, hemos mantenido el mismo enfoque y esquema básicos para esta nueva versión. Esperamos que estos cambios te ayuden a ampliar tu propio viaje en el camino hacia la gestión continua de las API.

Quién debería leer este libro

Si estás empezando a crear un programa de API y quieres comprender el trabajo que te espera, o si ya tienes API pero quieres aprender a gestionarlas mejor, éste es tu libro.

En este libro, hemos intentado construir un marco de gestión de API que pueda aplicarse a más de un contexto. En estas páginas encontrarás orientaciones que te ayudarán a gestionar una única API que quieras compartir con desarrolladores de todo el mundo, así como consejos para construir un complejo conjunto de API en una arquitectura de microservicios diseñada sólo para desarrolladores internos, y todo lo demás.

También hemos escrito este libro para que sea lo más tecnológicamente neutral posible. Los consejos y análisis que proporcionamos son aplicables a cualquier arquitectura basada en API, incluidos el Protocolo de Transferencia de Hipertexto (HTTP), Crear/Leer/Actualizar/Borrar (CRUD), Transferencia de Estado Representacional (REST), GraphQL y estilos de interacción basados en eventos. Este es un libro para cualquiera que quiera mejorar las decisiones que toma sobre sus API.

Qué contiene este libro

Este libro contiene nuestro conocimiento colectivo de muchos años dedicados al diseño, desarrollo y mejora de APIs, tanto propias como ajenas. Hemos destilado toda esa experiencia en este libro. Hemos identificado dos factores esenciales para el desarrollo eficaz de API: adoptar una perspectiva de producto e implantar el tipo de equipo adecuado. También hemos identificado tres factores esenciales para gestionar ese trabajo: gobernanza, madurez del producto y diseño del entorno.

Estos cinco elementos de la gestión de API forman una base sobre la que puedes construir un programa de gestión de API de éxito. En este libro, presentamos cada uno de estos temas y te orientamos sobre cómo darles forma para que se adapten a tu propio contexto organizativo.

El esquema

Hemos organizado el libro de forma que el alcance de las preocupaciones de gestión crezca a medida que avanzas en los capítulos. Empezamos introduciendo los conceptos fundamentales de la gobernanza basada en decisiones y la API como producto. A continuación, hacemos un recorrido por todo el trabajo que debe gestionarse al crear un producto API.

A partir de esta simple visión de una sola API, añadimos el aspecto del tiempo, al sumergirnos en lo que significa cambiar una API y cómo influye la madurez de la API en esas decisiones de cambio. A esto le sigue una exploración de los equipos y las personas que realizan ese trabajo de cambio. Finalmente, en la última mitad del libro, abordamos las complejidades de la escala y los retos de gestionar un panorama de productos API.

Aquí tienes un breve resumen de lo que encontrarás en cada capítulo:

• El capítulo 1, "El reto y la promesade la gestión de las API", presenta el ámbito de la gestión de las API y explica por qué es tan difícil gestionarlas con eficacia.

• El capítulo 2, "Gobernanza de las API", explora la gobernanza desde la perspectiva del trabajo basado en decisiones, un concepto fundamental para la gestión de las API.

• El capítulo 3, "La API como producto", establece la perspectiva de la API como producto y por qué es una parte esencial de cualquier estrategia de API.

• El capítulo 4, "Los pilares de un producto API", esboza los diez pilares esenciales del trabajo en el ámbito de los productos API. Estos pilares forman un conjunto de tareas de toma de decisiones que deben gestionarse.

• El Capítulo 5, "Mejora continua de la API", ofrece una visión de lo que significa cambiar continuamente una API. Introduce la necesidad de adoptar una mentalidad de cambio continuo y proporciona una comprensión de los diferentes tipos de cambios de API (y sus impactos) que te encontrarás.

• El capítulo 6, "Estilos de API", es un capítulo nuevo para esta edición. Explora los cinco estilos de API más comunes que vemos cuando visitamos empresas de todo el mundo y profundiza en los puntos fuertes y los inconvenientes de cada estilo para ayudarte a seleccionar los adecuados para cada caso de uso que te encuentres.

• El capítulo 7, "El ciclo de vida del productoAPI", presenta el ciclo de vida del producto API, un marco que te ayudará a gestionar el trabajo de la API en los diez pilares a lo largo de la vida de un producto API.

• El capítulo 8, "Equipos API", aborda el elemento humano de un sistema de gestión de API, explorando las funciones, responsabilidades y patrones de diseño típicos de un equipo API a lo largo de la vida de un producto API.

• El capítulo 9, "Paisajes de las API", añade la perspectiva de la escala al problema de la gestión de las API. Presenta las ocho V -variedad, vocabulario, volumen, velocidad, vulnerabilidad, visibilidad, versionado y volatilidad- que deben abordarse cuando varias API cambian al mismo tiempo.

• El capítulo 10, "Viaje al paisaje de la API", describe un enfoque de diseño continuo del paisaje para gestionar los cambios de la API de forma continua y a escala.

• El capítulo 11, "Gestión del ciclo de vida de la APIen un entorno en evolución", vuelve a situar la perspectiva del entorno en la perspectiva de la API como producto e identifica cómo cambia el trabajo de la API cuando el entorno evoluciona a su alrededor.

• El capítulo 12, "Continuar el viaje", enlaza la historia de la gestión de las API que ha surgido y ofrece consejos para prepararse para el futuro e iniciar tu viaje hoy.

Lo que no hay en este libro

El ámbito de la gestión de API es grande, y existe una enorme variación de contextos, plataformas y protocolos. Dadas las limitaciones de tiempo y espacio a la hora de escribir un libro, nos resultaba imposible abordar todas las prácticas de implementación específicas del trabajo con API. Este libro no es una guía para diseñar una API REST ni para elegir un producto de pasarela de seguridad. Si buscas una guía prescriptiva para escribir código API o diseñar una API HTTP, éste no es el libro adecuado para ti.

Aunque tenemos ejemplos que hablan de prácticas específicas, éste no es un libro centrado en la implementación de API (la buena noticia es que ya hay muchos libros, blogs y vídeos disponibles para ayudarte a cubrir esa necesidad). En su lugar, este libro aborda un problema que rara vez se trata: cómo gestionar eficazmente el trabajo de crear API dentro de un sistema organizativo complejo y en continuo cambio.

Convenciones utilizadas en este libro

En este libro se utilizan las siguientes convenciones tipográficas:

Cursiva

Indica nuevos términos, URL, direcciones de correo electrónico, nombres de archivo y extensiones de archivo.

Constant width

Indica elementos del programa como nombres de variables o funciones, tipos de datos, sentencias y palabras clave.

Constant width italic

Muestra el texto que debe sustituirse por valores proporcionados por el usuario o por valores determinados por el contexto.

Consejo

Este elemento significa un consejo o sugerencia.

Nota

Este elemento significa una nota general.

Advertencia

Este elemento indica una advertencia o precaución.

Aprendizaje en línea O'Reilly

Nota

Durante más de 40 años, O'Reilly Media ha proporcionado formación tecnológica y empresarial, conocimientos y perspectivas para ayudar a las empresas a alcanzar el éxito.

Nuestra red única de expertos e innovadores comparten sus conocimientos y experiencia a través de libros, artículos y nuestra plataforma de aprendizaje online. La plataforma de aprendizaje en línea de O'Reilly te ofrece acceso bajo demanda a cursos de formación en directo, rutas de aprendizaje en profundidad, entornos de codificación interactivos y una amplia colección de textos y vídeos de O'Reilly y de más de 200 editoriales. Para más información, visita http://oreilly.com.

Cómo contactar con nosotros

Por favor, dirige tus comentarios y preguntas sobre este libro a la editorial:

• O'Reilly Media, Inc.
• 1005 Gravenstein Highway Norte
• Sebastopol, CA 95472
• 800-998-9938 (en Estados Unidos o Canadá)
• 707-829-0515 (internacional o local)
• 707-829-0104 (fax)

Tenemos una página web para este libro, donde se enumeran erratas, ejemplos y cualquier información adicional. Puedes acceder a esta página en https://oreil.ly/cam-2e.

Envía un correo electrónico a [e-mail] para comentar o hacer preguntas técnicas sobre este libro.

Para obtener noticias e información sobre nuestros libros y cursos, visita http://oreilly.com.

Encuéntranos en Facebook: http://facebook.com/oreilly

Síguenos en Twitter: http://twitter.com/oreillymedia

Míranos en YouTube: http://youtube.com/oreillymedia

Agradecimientos

Una vez más, tenemos que dar las gracias a muchas personas por toda la ayuda y el apoyo que hemos recibido al recopilar nuevo material para esta segunda edición. Como de costumbre, nuestro primer agradecimiento va dirigido a todas las personas a las que consultamos y tuvimos el privilegio de entrevistar, y a todos los que asistieron a nuestros talleres y seminarios web en línea. Los comentarios fueron estupendos, y aprendimos algo nuevo con cada encuentro. Gracias también a la gente de NGINX, que nos animó a revisar este libro y nos ayudó a patrocinar el trabajo. Un agradecimiento especial a todos los que leyeron los primeros borradores y nos ayudaron a dar forma al libro final que tienes ante ti. También nos gustaría dar las gracias a James Higginbotham, Hibri Marzook, Marjukka Niinioja y Matthew Reinbold por todo el tiempo que dedicaron a leer y revisar nuestro trabajo y a indicarnos cómo podíamos mejorarlo. Y, por supuesto, nada de esto sería posible sin el apoyo de la gente de O'Reilly Media. Nuestro agradecimiento a Melissa Duffield, Gary O'Brien, Kate Galloway, Kim Wimpsett y muchos otros que dedicaron su tiempo y talento a ayudarnos a organizarlo todo.