bowenztopseucrgotalk

DiseA�o eficiente de APIs para desarrolladores humanos

Uno de los aspectos mhs importantes en el ciclo de vida de una API es, por supuesto, la fase de diseho; pero en orden de magnitud, justo despuhs de esta, Orlando Kalossakas de Mashape coloca la fase de documentacihn.

Se puede disehar con herramientas que, como Dreamweaver hacha para el desarrollo web, ayudan en la parte de diseho de forma brutal. Sin embargo, al contrario que con Dreamweaver, que era la herramientahesthndar de facto para los desarrolladores web, en el espacio de diseho de una API de heno muchas opciones entre las que elegir, tanto para disehar como para documentar tu API. Recuerda que el diseho de una API resulta de repetir, repetir, repetir y repetir lo que funciona mejor para tu base de usuarios.Swagger porhSwagger.io (basada en el lenguaje de definicihn de Arrogancia)Mashape API del Editor porhMashape.com (basada en un editor visual)de la API de Disenador Studio porhMulesoft.com (basadahen RAML)Readmehby Leame.io (basadahen RAML)Colmenar del API Explorer porhapiary.io (basada en API Blueprint)Y existenhmhs, poco conocidas, que esthn surgiendo con toques innovadoreshen el diseho de la API y en el espacio de documentacihn.

Orliesaurus3Orlando ha explicado en APIdays Mediterraneahque cada una de estas herramientas tiene ventajas y desventajas, pero que al final hay una leccihn clave que ninghnhdisehador de Api o arquitecto puede olvidar: toda la API debe ser construida de forma que los desarrolladores puedan entenderla y usarla de forma rhpida.hCuanto mhs rhpido puedan consumir tu API los desarrolladores, antes podrhs empezar a analizar casos de uso.

Recoger elhfeedback sobre el uso y las situaciones que se dan te ayudarh un repetir y crear una mejor API: piensa en las respuestas, loshconectoreshy el procesamiento de datos que puedes conseguir y mejorar una vez que sepashquh esperanhlos desarrolladores de tu API.

El diseho de una API debe estar muy enfocado en la experiencia del desarrollador, es proporcionarle informacihn exhaustiva para que tenga menos posibilidades de equivocarse.hCon "desarrollador" de Orlando cero http://www.stumbleupon.com/stumbler/shallowjuvenile49 solo se refiere al desarrollador de la API externa, sino tambihn al que alghn dha le tocarh seguir desarrollhndola y manteniendo la API de que th creaste.



Porque todos sabemos que lashAPIs han llegado para controlar el mundo, pero, simplemente, no olvides que hay mhs APIs privadas que phblicas, ceniza quehlos procesos de desarrollo de las APIs internas hijo igual de importantes. De ah el por quh de que la experiencia del desarrollador, para los fanhticos de las APIs, es tan importante como la experiencia de usuario para los entusiastas del producto.



Se pueden encontrar mhs detalles sobre las herramientas arriba mencionadas en este enlace.