Header Ads Widget

Ticker

6/recent/ticker-posts

Madurez API para humanos

 


A los expertos en API les encantan los modelos de madurez. Hemos tenido algunos a lo largo de los años, como  Richardson , Admunsen y el reciente Curity API Security Model . Al observar críticamente tanto el estilo como las propiedades de las API que creamos, estos modelos nos brindan información valiosa sobre cómo progresamos en nuestro viaje para convertirnos en dioses y diosas de las API.

Este amor por los modelos de madurez es una sorpresa dado lo inmaduros que somos la mayoría de los que trabaja con software. Pop Funkos, sables de luz, camisetas de Star Wars… todas las señas de identidad de no querer crecer, disfrutar de los artefactos del geekery que son un reflejo de cómo prosperamos como diseñadores, desarrolladores o lo que nos guste etiquetarnos. Nuestra vida laboral gira en torno a nuestro Universo Extendido de conocimiento que viene con el dominio de nuestro lenguaje de programación favorito. ¿Quizás es hora de reflexionar sobre nosotros mismos y nuestros niveles de madurez como seres humanos en lugar de solo productores de API?

Con esto en mente, este artículo propone un nuevo modelo de madurez: uno para humanos . En él, exploraremos cómo nos desarrollamos como profesionales de API en términos del crecimiento tanto de nuestras habilidades como de nuestra conciencia, en lugar de las propiedades de las API que producimos.

Introducción: "Adquirir" un modelo

API Maturity for Humans se inspiró en los niveles de desarrollo cognitivo detallados en Things That Make Us Smart , de Don Norman.

El verdadero pensamiento original es un bien que es difícil de conseguir. Por tanto, tomar las ideas de otras personas y ampliarlas o contextualizarlas para los propios fines es bastante típico. La madurez de API para humanos no es una excepción. Imita un modelo de desarrollo cognitivo propuesto por Don Norman en su libro Things that Make Us Smart , que a su vez se basa en uno creado por Mervin Donald en Origins of the Modern Mind . Luego lo apliqué a cómo crecemos como profesionales de API.

El modelo propone cuatro etapas de desarrollo cognitivo durante la evolución de los seres humanos, a saber:

  • Episódico (llamado Experiencial por Don Norman).
  • Mimetismo.
  • Mítico.
  • Representación externa.

Cada una de estas fases del desarrollo humano tomó muchos milenios. Sin embargo, el espíritu de cada uno, que discutiremos a continuación, se puede aplicar a cómo ganamos y perfeccionamos nuestras habilidades como personas de API.

Fase 1: Episódica

En el modelo original, se preveía que la etapa episódica ocurría cuando pasamos del ancestro común que compartimos con los simios a los primeros humanos. El desarrollo del cerebro humano primitivo fue influenciado por eventos - "episodios" - que cambiaron la comprensión de nuestros antepasados ​​del mundo que los rodeaba: el efecto de los elementos, las amenazas a la seguridad y las interacciones en el paisaje jugaron su papel en el desarrollo de la conciencia.

La perspectiva de la API en esto se caracteriza por la necesidad de "empezar por algún lado". Para los nuevos participantes en la economía de las API, la fase episódica es el comienzo de su desarrollo como profesionales, donde un evento activa su "conciencia" de API. Puede ser una interacción con un colega, leer una publicación de blog o una nueva característica del producto que la activa. Podría ser el resultado de intentar resolver un problema o mejorar el negocio. El resultado neto es una conciencia de para qué sirve una API y por qué es importante.

Aquí hay diferentes cursos para diferentes caballos, y es probable que la conciencia refleje la profesión elegida. Un desarrollador de software, por ejemplo, apreciará una API más rápidamente y con mayor profundidad que un gerente de producto y, por lo tanto, puede pasar por la fase episódica más rápidamente. Además, al ser un desarrollador de software, tendrá los medios para actuar en su trabajo diario.

Sin embargo, la fase episódica es esencial simplemente por el hecho de que los aspirantes a profesionales pueden comenzar a utilizar las API como una herramienta para su trabajo. Actuar sobre esa conciencia comienza a manifestarse concretamente en la fase de Mimesis.

Recursos episódicos

Para los principiantes de la API, hay algunos artículos en nuestro blog que pueden ser de interés:

  • Para saber qué es una API, lea ¿Qué es una API?
  • Para obtener una descripción general de la economía de las API, lea nuestra introducción a las API .
  • Si está interesado en los diferentes estilos de API, lo desglosamos en nuestra publicación sobre taxonomías de API .
  • Para aquellos que están construyendo un negocio de API por primera vez, considere esta implementación de API por primera vez para emprendedores .

Fase 2: Mimesis

Donald concibió la mimesis como la etapa en la que los humanos comenzaron a actuar, la mímica, como un medio para ayudar a comunicar sus deseos y necesidades. Al hacer esto, comenzaron a dirigir sus representaciones internas - su conocimiento de un evento o actividad dado - hacia afuera, ayudándoles a establecer los rudimentos del lenguaje. Don Norman define esto como el momento en que "la comunicación sofisticada y los estados mentales se vuelven posibles".

En el mundo de las API, nuestro aspirante a practicante de API comienza a hacer lo mismo, utilizando su conocimiento recién descubierto para diseñar, construir, planificar o elaborar estrategias sobre las API, imitando su representación interna para comunicar sus ideas a los demás. Sus percepciones tienen un contexto limitado; saben lo que saben de esos primeros episodios y es casi seguro que utilizarán experiencias anteriores para informar cómo abordan la tarea que tienen por delante.

Este contexto limitado puede conducir al lado oscuro de la mimesis, es decir, la propagación del pensamiento API que utiliza la representación interna como influencia principal. Los ejemplos del lado oscuro son bastante evidentes para los iniciados. Los pecados capitales de los antipatrones de diseño de API , por ejemplo, se manifiestan en la fase de Mimesis:

  • Verbos en la URI
  • todo es un POST
  • Todas las respuestas devuelven 200 (errores y todo)
  • etcétera etcétera.

No solo los diseñadores y desarrolladores novatos de API se sienten atraídos por el lado oscuro. Los arquitectos, propietarios de productos y ejecutivos menos prácticos también pueden ser víctimas. Tomemos esta frase, por ejemplo, que se repite con frecuencia en las organizaciones pero que rara vez se pronuncia en público:

"Bueno, tenemos interfaces para nuestra mensajería en [insertar el nombre de la plataforma] ... así que realmente ya estamos haciendo API, ¿no es así?"

Semánticamente, la declaración podría considerarse cierta, pero despoja al hablante de comprometerse a adoptar API abiertas, justificando y reforzando el status quo como una "victoria".

El lado oscuro de Mimesis, por supuesto, no ha ganado el día. La economía API continúa floreciendo, y eso se debe principalmente a que los profesionales aprenden tanto de sus propias experiencias como de los demás. Ese aprendizaje de los demás nos lleva a la siguiente etapa de nuestro desarrollo como personas API, la fase mítica.

Recursos de mimesis

Hacer las cosas bien y navegar a través de la jerga puede ser difícil al principio. Muchos artículos de nuestro blog ayudan a aclarar las cosas, que incluyen:

  • Nuestra guía de 9 métodos HTTP comunes  desglosa para qué sirven y cómo usarlos.
  • Recomendaciones sobre el desarrollo de herramientas, incluido el poder del poderoso Curl
  • Si se está despegando de CORS al llamar a las API desde su aplicación JavaScript, nuestra descripción general podría ser de ayuda.
  • Si no es un desarrollador, pero se está involucrando en el programa API de su organización, nuestra guía sobre cómo iniciar un programa de desarrollador asociado puede ayudar.
  • Conozca el potencial comercial de las API aquí: 8 formas en las que conectarse a las API ayuda a los negocios .
  • Describimos cómo descubrir y aprovechar los datos subyacentes en Cómo valorar sus datos al proporcionar una API .
  • Aprenda a tratar su API como un producto .

Fase 3: Mítica

La mimesis es, por supuesto, insuficiente para que los humanos comuniquen cualquier cosa que no sea información básica. No hay forma de utilizar la entonación o la expresión para transmitir sutilmente o matices. En el modelo de Donald, la mimesis se complementa por tanto con el desarrollo del lenguaje y una creciente riqueza y sofisticación en la comunicación de conceptos y amplitud de vocabulario. La sofisticación que caracteriza esta fase se logra a través de la mitología o, más claramente, la narración .

La narración de historias siempre ha sido fundamental para la forma en que aprendemos y, a medida que Internet ha crecido, ha sido importante para nuestro aprendizaje como tecnólogos a través de publicaciones en blogs, instructivos, etc. Este medio de contar historias siempre ha existido durante el crecimiento de la economía API. Sin embargo, las características de la fase Mythic han cambiado a medida que se desarrolló la API Economy. Cuando las API web comenzaron a convertirse en conceptos básicos populares del lenguaje que compartimos (estilos arquitectónicos como REST, construcciones que luego se integraron en lenguajes de especificación como OpenAPI Specification) no eran omnipresentes. Como grupo flexible de profesionales, los proveedores de API y los desarrolladores que consumen esas API necesitan desarrollar un léxico para interactuar utilizando terminología común.

Con el tiempo, estas tecnologías y el vocabulario que las rodea se han convertido en la base de nuestro conocimiento, y los profesionales y proveedores de API refuerzan la experiencia a través del mismo acto de contar historias y compartir un monólogo colectivo. Este acto de contar historias también crea y fortalece la comunidad; sin ella, la Economía API como concepto y como realidad no existiría.

La fase mítica, por lo tanto, ayudó a construir las bases del lenguaje compartido de las API. Esta mayor madurez condujo naturalmente a la cuarta fase de nuestro desarrollo como practicantes de API, la de Representación Externa.

Recursos míticos

Con el aumento del conocimiento de API, viene la capacidad de ser cada vez más sofisticado en el diseño, desarrollo y estrategia de API. Tenemos una variedad de publicaciones que lo ayudan:

  • Sepa qué estilo de API usar y cuándo: REST, GraphQL, Webhooks y gRPC .
  • Para ayudar a estandarizar un monólogo de API compartido, considere adoptar las mejores prácticas para cosas como el diseño de API REST , la paginación , el manejo de errores , el control de versiones , la retirada y las convenciones de nomenclatura de puntos finales .
  • Las API necesitan una experiencia de desarrollador de calidad . A continuación, se ofrecen consejos sobre relaciones con los desarrolladores , alcance para desarrolladores y reducción de la fricción de las API para que sean más útiles.
  • Esté atento a las vulnerabilidades comunes , aprenda a probar las API y proteja su plataforma de API contra amenazas.

Fase 4: Representación externa

En el modelo de Donald, la Representación Externa  es cuando nos convertimos en humanos modernos, con escritura y herramientas para apoyar nuestra mente en continuo desarrollo. Norman llama a estos dispositivos externos "artefactos cognitivos" y los destaca por ofrecer los medios para ir más allá de nuestra "herencia biológica".

No es difícil ver los paralelismos con nuestro desarrollo como profesionales de API. Tenemos un conjunto cada vez más rico de herramientas a nuestra disposición que nos permiten ser aún más efectivos en cómo diseñar, construir y comunicar nuestras API.

Muchas de estas herramientas sustentan algunas de las prácticas que se han convertido en algo común en la línea de productos API, especialmente el diseño de API primero. Ejemplos incluyen:

  • Diseño : las herramientas Swagger han establecido el estándar para el diseño cuando se usa el lenguaje de especificación OpenAPI , pero la amplitud y la profundidad continúan aumentando a partir de Stoplight, que crea herramientas de diseño de uso gratuito que permiten a los profesionales de API modelar y comunicar sus diseños de API en una forma perfecta.
  • Colaboración : los seres humanos necesitan los medios para comunicarse de manera eficaz, especialmente con nuestra fuerza laboral cada vez más distribuida. La facilidad de colaboración es importante en el momento del diseño de la API, y herramientas como SwaggerHub y Postman Collections permiten que esto suceda de manera efectiva.
  • Exploración : en el modelo más destacado para los proveedores de API, donde hacen que la información sobre sus API esté disponible a través de un portal, la exploración es de vital importancia para los desarrolladores que buscan integrarse con una API determinada. Las herramientas disponibles aquí son casi demasiado numerosas para mencionarlas. Aún así, todos respaldan la funcionalidad del portal, y los excelentes portales que existen, que permiten a los proveedores hacer que la exploración se realice de manera efectiva.

La Representación Externa es, por lo tanto, la piedra angular de cómo nos comunicamos como comunidades de practicantes de API en diseño, desarrollo y entrega. Apoya todo lo que hemos aprendido en nuestra maduración y nos brinda los medios para ser más productivos.

Recursos de representación externa

El uso de las herramientas adecuadas lo ayudará a tener éxito como practicante de API, independientemente de su competencia y conocimiento. Varios artículos pueden ayudarlo a sumergirse por completo y comprender su valor, por ejemplo:

  • Hemos revisado muchos marcos para crear API en Go, Python, Node.js, Java, Scala, Clojure, PHP, Rust y Elixir.
  • Compare nuestras listas de herramientas de administración de API y soluciones de documentación de API aquí en nuestras listas completas de proveedores y soluciones de código abierto.
  • Consulte OAuth.tools y otros recursos para definir conceptos de seguridad estrictos .
  • Hemos revisado AsyncAPI , una alternativa basada en mensajes a OpenAPI.
  • Recientemente revisamos Postwoman , un generador de solicitudes de API de código abierto y esbelto.
  • La simulación se considera vital para el proceso de desarrollo, y cubrimos el uso de servidores simulados en esta publicación.

Pensamientos finales

En esta publicación, hemos explorado cómo los seres humanos, como individuos y como colectivo de practicantes de API, desarrollan los artefactos para recolectar y expresar un fenómeno tecnológico. Claramente, los modelos subyacentes se basan en el desarrollo del pensamiento cognitivo a lo largo de muchos eones y la Economía API que ha existido durante, como máximo, decenas de años. Sin embargo, esos elementos fundamentales, un episodio o evento que desencadena el desarrollo de una conciencia compartida entre un grupo de personas, se ajusta a cómo nos desarrollamos como profesionales de la tecnología, ya sea en el campo de las API o no.

Lo que los modelos no abordan es cómo seguirá evolucionando nuestra conciencia. ¿Tendremos la tecnología como la IA con el potencial de superar los límites de nuestra herencia biológica y desarrollarse de formas que no podemos prever (excepto en la trama de una película de ciencia ficción)? La parte más emocionante de este modelo es, por tanto: ¿qué sucede a continuación ?


Esta publicación se basa en una sesión celebrada en la ABN AMRO Unconference en mayo de 2019. Koen Adolfs, Product Owner para Open Banking and Enterprise Integration Technology, organizó el evento.

Publicar un comentario

0 Comentarios