Werner Vogels – 6 lecciones aprendidas para un buen diseño de API

 (aws.amazon.com)
30 puntos por xguru 2022-01-26 | 4 comentarios | Compartir por WhatsApp
  • Notas sobre las “6 principios para crear buenas API que AWS aprendió en 15 años”

  1. ¡Las API son para siempre!

  2. Mantén la compatibilidad hacia atrás.

  3. Diseña partiendo en reversa de los casos de uso de los clientes.

  4. Crea API con errores explícitos.

  5. Crea API cuyo propósito y forma de uso se entiendan de inmediato.

  6. Procura que no se filtren los detalles de implementación.

  • Lo que se hace mal en el diseño inicial de una API

  • Cómo crear API altamente escalables con Smithy

Lecturas relacionadas

4 comentarios

 
xguru 2022-01-30
 
edunga1 2022-01-26

Creo que el punto 5 fue el que más me resonó.

Ya había visto el recurso citado, "¿Está bien una REST API así?", y me pareció bueno: https://tv.naver.com/v/2292653

No suelo prestar atención a este tipo de información semántica, pero cuando ves la API de GitHub, también entrega muy bien ese tipo de información, así que da la impresión de que está bien hecha.
 
ehlegeth 2022-01-26

Parece que es un contenido muy bueno.

En particular, creo que los puntos 1 y 4 son temas que siempre terminamos comentando al hacer una revisión.

El punto 3 también parece conectar con lo que decía Joshua Bloch: "Write to Your API Early and Often". (https://www.youtube.com/watch?v=aAb7hSCtvGw)
 
nicewook 2022-01-26

Cuando lo ordenas así, parece algo obvio, pero luego, al momento de hacerlo en la práctica, sientes que sigues cometiendo los mismos errores una y otra vez.