Uno de los aspectos más importantes en el ciclo de vida de una API es, por supuesto, la fase de diseño; pero en orden de magnitud, justo después de esta, Orlando Kalossakas de Mashape coloca la fase de documentación.
Se puede diseñar con herramientas que, como Dreamweaver hacía para el desarrollo web, ayudan en la parte de diseño de forma brutal. Sin embargo, al contrario que con Dreamweaver, que era la herramienta estándar de facto para los desarrolladores web, en el espacio de diseño de una API hay muchas opciones entre las que elegir, tanto para diseñar como para documentar tu API. Recuerda que el diseño de una API resulta de repetir, repetir, repetir y repetir lo que funciona mejor para tu base de usuarios.
- Swagger por Swagger.io (basada en el lenguaje de definición de Swagger)
- Mashape’s API Editor por Mashape.com (basada en un editor visual)
- API Designer Studio por Mulesoft.com (basada en RAML)
- Readme by Readme.io (basada en RAML)
- Apiary’s API Explorer por apiary.io (basada en API Blueprint)
Y existen más, poco conocidas, que están surgiendo con toques innovadores en el diseño de la API y en el espacio de documentación.
Continúa leyendo «Diseño eficiente de APIs para desarrolladores humanos»