Header Ads Widget

Ticker

6/recent/ticker-posts

Implementación de API por primera vez para emprendedores


 Cualquier empresa u organización del mundo puede llevar una API al mercado, pero las API son cada vez más sinónimo del mundo de las startups . Los emprendedores utilizan API para entregar sus productos por varias razones:

  • Pueden proporcionar un mecanismo conveniente, fácil de entender y accesible para presentar un MVP a los clientes;
  • Tener una API en el mercado puede proporcionar información crucial sobre el valor de su producto a través de los comentarios de la comunidad de desarrolladores;
  • Una API puede ser uno de varios canales para entregar su producto o puede ser el producto en sí.

Sin embargo, como ocurre con la mayoría de los proyectos de tecnología, entregar una API al mercado es una combinación de tareas "imprescindibles" y "posibles". Decidir qué cae en el grupo de "debe hacer" puede ser muy subjetivo, especialmente en lo que respecta a las API REST y el intenso debate que el tema puede generar.

Llevar una API al mercado debería centrarse en ofrecer el máximo valor de la forma más eficiente posible. En esta publicación, analizamos algunas ideas que pueden ayudar a los emprendedores de API por primera vez a lograr esto.

Consulte nuestra publicación sobre cómo comenzar su viaje de API pública para obtener una guía general sobre cómo convertirse en un proveedor de API.

Centrarse en el producto

Si está creando una API, es posible que esté creando microservicios y API internas como la columna vertebral de su arquitectura: sin embargo, es probable que también se esté concentrando en crear una API pública o asociada que sea el mecanismo para vender su producto o servicio único. Por esta razón, debe asegurarse de tratar su API como un producto, prestando la debida atención a la creación de lo que es importante para sus clientes. La visión de las API como producto es interesante y, a menudo, se yuxtapone entre los objetivos técnicos y comerciales de las API. Erik Wilde tuiteó recientemente esto sobre las API y las empresas de productos:

Si esta perspectiva es válida, entonces los emprendedores que traen productos basados ​​en API al mercado que quieran sobresalir como proveedores de API también deben dar a sus clientes razones convincentes para seguir siendo clientes: si las API son realmente reemplazables , esto naturalmente reduce la rigidez de las API como producto. Con esto en mente, tratar su API como un producto debe garantizar que su experiencia de desarrollador sea ​​insuperable: creará un revuelo en torno a su producto, hará que su mercado objetivo hable y creará la rigidez que será tan vital para mantener lealtad del cliente . Hay una serie de áreas en las que debe concentrarse:

  • Documentos : entregue documentación clara y concisa que les diga a sus clientes exactamente lo que necesitan saber para familiarizarse con su API;
  • Procedimientos : asegúrese de complementar su documentación con procedimientos, ejemplos y tutoriales que den vida a su API. Siempre que sea posible, adapte la experiencia al contexto del lector, incorporando su clave API o token de acceso al desarrollo en los ejemplos para facilitar su uso;
  • Monetización : Comunique de manera transparente su estrategia de monetización desde el primer día. Por ejemplo, si inicialmente ofrece una versión beta gratuita que se convertirá en un plan de pago una vez que su API esté disponible de forma generalizada, debe informar a sus clientes de esto, ya que aumentará su confianza en usted y generará lealtad para el futuro. ;
  • Agilidad : si desea escalar rápidamente su API, el autoservicio es primordial, así que asegúrese de que la incorporación de desarrolladores sea lo más autosuficiente posible. Esto debe incluir tanto el portal externo como los procesos internos, como la aprobación de nuevas cuentas. Considere ChatOps u otras formas de maximizar la productividad de sus equipos internos.
Para obtener más antecedentes sobre ChatOps, consulte nuestra publicación reciente que analiza el enfoque con más detalle.

Simplicidad de diseño

Si bien hay muchos absolutos en el mundo de las API REST , todavía existe subjetividad con respecto al diseño óptimo de una API. El tema puede ser divisivo, especialmente cuando se discuten áreas como hipermedia y la opinión de que las API no son RESTful sin él: tales temas pueden generar un debate furioso que es de naturaleza bastante técnica y no siempre es particularmente constructivo. Por lo tanto, la simplicidad del diseño significa evitar ese debate y centrarse en crear una API que se adhiera a la mayoría de las prácticas de diseño comúnmente aceptadas para las API REST, al tiempo que proporciona algo significativo para su público objetivo. Dicho enfoque podría incluir lo siguiente:

  • Asegúrese de que las construcciones de sus recursos sean simples de seguir, posiblemente limitando sus URI raíz a un solo fragmento, por ejemplo, / pets;
  • Decida exactamente cómo utilizará los distintos atributos de HTTP, como los parámetros de consulta y los encabezados, y luego céntrese en esas decisiones;
  • Piense en cómo utilizar el nombre de host de su API para facilitar la simplicidad. Por ejemplo, puede incluir un número de versión principal o, si es práctico, utilizar subdominios para demarcar diferentes áreas de su API que están lógicamente separadas;
  • Ignore la arrogancia y piense detenidamente hasta qué punto adoptará los hipermedia . Si tiene sentido hacer todo lo posible para crear una API de hipermedia que sus clientes comprenderán fácilmente , adopte este enfoque desde el principio;
  • Implemente un modelo de seguridad que sea una respuesta adecuada a los deseos y necesidades de sus clientes. Por ejemplo, si el caso de uso más probable para su API es crear integraciones de servidor a servidor, su modelo de seguridad podría ser muy sencillo, solo involucra claves de API para identificar aplicaciones consumidoras mientras se trata la identidad del usuario como un atributo de datos;
  • Por encima de todo, adopte prácticas de diseño basadas en API , utilizando un lenguaje de descripción de API para crear su especificación. Esta práctica le permitirá concentrarse en las necesidades de su cliente en lugar de acoplar su API pública al backend que ya haya creado.

Algunos aspectos de su API solo serán significativos para el contexto del producto o servicio que está trayendo al mercado, así que esté preparado para tener cierta flexibilidad en estas áreas de diseño. Sin embargo, si se centra en la simplicidad del diseño, podrá crear un MVP mucho más rápidamente.

¿Necesita saber más sobre las especificaciones API? Lea nuestra publicación sobre su papel en la creación de una API.

Enfoque simple para la gestión de API

La necesidad de administración de API se ha convertido prácticamente en un hecho al implementar API. Existe una gran cantidad de soluciones en el mercado, que incluyen tanto productos de código abierto como comerciales, así como una gran cantidad de interpretaciones subjetivas sobre la disciplina. Los emprendedores por primera vez que están creando una solución desde cero tienen privilegios únicos: es más probable que estén creando una implementación nueva con un conjunto de API RESTful que requieren mediación limitada, transformación o cualquier otra característica de la gestión de API que tiende a estar asociada con exponer los servicios heredados como una API RESTful.

Por lo tanto, para las empresas emergentes, el rol de la administración de API puede estar contenido en la funcionalidad principal que puede entregar en nombre de las API que expone, como hacer cumplir la seguridad, limitar la velocidad y proporcionar información de administración sobre la utilización. La gestión de API también puede ofrecer elementos de la experiencia del desarrollador, como proporcionar un portal y un explorador interactivo . Por lo tanto, los criterios para realizar una selección de productos de gestión de API se pueden reducir rápidamente a las características principales, descontando muchas de las soluciones infladas (y a menudo caras) que se encuentran en el mercado y centrándose en productos esbeltos y fáciles de implementar. .

Para obtener más información sobre la gestión de API, lea nuestra publicación sobre sus principios básicos.

Esté preparado para la próxima versión

Llevar su API al mercado por primera vez hará que su producto esté frente a los consumidores, pero es probable que no sea perfecto y seguramente querrá agregar nuevas funciones con el tiempo. Por lo tanto, debe planificar el futuro desde el principio y adoptar una estrategia de control de versiones que sea sostenible, fácil de mantener y, sobre todo, simple de seguir para los clientes. Hay una serie de enfoques comunes para el tema a menudo espinoso del control de versiones:

  • Muchos proveedores de API incurren en el desdén de la comunidad "RESTafarian" al implementar el control de versiones en el URI ;
  • Otros usan encabezados HTTP , ya sea modificando los encabezados AcceptContent-Typeo usando un encabezado personalizado;
  • También hay varios enfoques que pueden hacer que sus API sin versión de manera efectiva, como el uso de un método propio basado en metadatos (como el enfoque empleado por Badoo , que fue explorado por Konstantin Yakushev en nuestra cumbre o un enfoque hipermedia similar y completo.

Cualquiera sea el método que elija, asegúrese de adoptar y publicitar su método de control de versiones desde la primera versión: hacer esto desde el principio inspirará confianza en usted a los clientes potenciales, ya que comprenderán las implicaciones de adoptar nuevas versiones. Al igual que con la monetización, esa confianza genera lealtad y en la economía API, donde un producto puede transponerse cada vez más a otro, inspirar la lealtad del cliente es primordial. Además, deberá proporcionar documentación sobre su estrategia de control de versiones, ya que el soporte manifiesto para el control de versiones en la mayoría de los formatos de especificación de API aún no ha madurado hasta un nivel en el que sea lo suficientemente expresivo para proporcionar toda la información requerida.

Pensamientos finales

Iniciar una nueva empresa comercial y llevar un producto al mercado por primera vez es tumultuoso incluso para los empresarios más experimentados. El uso de una API como vehículo para su producto puede ser una manera excelente de lograr la velocidad de comercialización y de incorporar rápidamente una nueva base de clientes. La clave del éxito es utilizar el valor de una API en su beneficio: al centrarse en ofrecer una API que sea fácil de usar y ofrezca una gran experiencia para el desarrollador, tendrá todas las posibilidades de crear un producto que tenga un impacto en El mercado.

Publicar un comentario

0 Comentarios