Los diez elementos esenciales de una buena documentación de un API [ENG]

La documentación de API es la referencia número uno para cualquiera que implemente su API, y puede influir profundamente en la experiencia del desarrollador. Debido a que describe los servicios que ofrece la interfaz de programación de aplicaciones y cómo utilizarlos, su documentación inevitablemente creará una impresión sobre su producto, para bien o para mal. Este artículo discute lo básico para crear buenos documentación de API.

[#1 --521337--]

OpenAPI/Swagger y fuera de perder tiempo con estas mierdas de escribir documentación, porque se escribe sola.

[#2 --59291--]

#1 Y/o API Gateway/Lambda si no te importa soltar algo de pasta a AWS.

[#3 --521337--]

#2 Sep. Yo no soy muy fan de Amazon, más por motivos prácticos y personales que por cualquier otra cosa, pero Lambda está de puta madre.