Header Ads Widget

Ticker

6/recent/ticker-posts

Consejos para mejorar la visibilidad de su API

 

Consejos para mejorar la capacidad de descubrimiento de su API

“Constrúyalo y ellos vendrán” ciertamente no es el caso en el mundo de las API. Incluso si tiene un servicio funcionalmente brillante, sin el posicionamiento correcto, sus tasas de conversión podrían ser muy bajas. Suponiendo que ha hecho que su programa de desarrollo sea visible para el público, ¿cómo debería promocionar su API?

Aún puede haber un enorme potencial de crecimiento en su servicio si tiene la representación en línea adecuada. Quizás no orquestó el lanzamiento de su lanzamiento inicial con suficiente entusiasmo, o el servicio no está posicionado de una manera que aumente su visibilidad en los motores de búsqueda, directorios de API y foros de la comunidad de una manera que resalte una propuesta de valor única.

Hacer correr la voz asistiendo y hablando en eventos, o realizando su propio hackathon puede ser una excelente publicidad. Mucho de esto depende naturalmente del boca a boca y del elemento humano-humano; no obstante, todavía hay mucho que puede hacer en línea para aumentar la exposición y la amplitud de su programa API y garantizar que se utilicen todas las posibles vías de crecimiento.

En este artículo, profundizamos en tres métodos entrantes que un proveedor puede usar para mejorar la capacidad de detección de su API:

  • SEO : Optimice las páginas de inicio de su API para que sean más fáciles de buscar.
  • Directorios de API : promocione su API enviándolo a nuestra hoja de trucos de más de 10 directorios.
  • Automatización del descubrimiento de servicios : aumente la capacidad de descubrimiento con técnicas legibles por máquina.

Enfoque SEO: Optimización de las páginas de inicio de la API

El método más obvio que usará un desarrollador para encontrar su API es a través de una búsqueda en Google. El SEO o la optimización de motores de búsqueda es, por lo tanto, una prioridad para cualquier startup. Haga que su página sea más fácil de buscar optimizando el contenido y los metadatos para que los motores de búsqueda de renombre destaquen continuamente su sitio. Como la economía de API está muy modificada , la optimización de palabras clave es un amigo cercano para muchos.

Frecuencia de palabras clave

Considere lo que buscaría un desarrollador cuando busca una determinada tecnología en su espacio. Como ejemplo de caso de uso, digamos que está ingresando al mercado de procesamiento de lenguaje natural con una API que acepta cuerpos de texto sin formato y proporciona estadísticas como el recuento de palabras, la frecuencia de palabras, el análisis de tonos y realiza otras funciones de PNL. Una frase de palabras clave de enfoque que un consumidor desarrollador potencial puede buscar sería " API de análisis de texto ".

El número y la frecuencia de palabras clave que se encuentran en la copia de los cinco resultados principales de una búsqueda en Google de "Análisis de texto" es el siguiente:

COMPAÑÍA"TEXTO""ANÁLISIS""API"
Aylien19 (6%)11 (3%)13 (4%)
AlquimiaAPI2 (1%)2 (1%)3 (1%)
Navaja de texto2 (1%)2 (1%)3 (1%)
Bitext6 (2%)6 (2%)20 (6%)
Saplo11 (3%)7 (2%)18 (5%)

Resultados de la búsqueda realizada el 5–4–2016.

Los algoritmos de Google para clasificar el contenido están en constante fluctuación, pero como puede ver arriba, a veces la clasificación de la página se reduce a algo tan simple como la frecuencia de las palabras clave. La presencia de Alyien se destaca del resto con esta búsqueda, ya que obtiene una alta densidad de palabras clave para los tres términos de búsqueda.

Permitir que su API se eleve naturalmente hacia arriba en las clasificaciones de búsqueda al enfocarse en una frase de enfoque, respaldada por una cartera diversificada de palabras clave de enfoque complementarias en el texto de su sitio será una herramienta poderosa en su arsenal de marketing. Esto significa que tener una descripción no técnica cuidadosamente redactada de la funcionalidad de la API es primordial para la optimización de motores de búsqueda.

Tener buenos metadatos de API también lo hace más visible para los motores de búsqueda específicos de API, como APIfinder en APIhound.com , o motores que usan el formato APIs.json para el descubrimiento (más sobre eso a continuación).

Páginas independientes que describen cada API

Echemos un vistazo más profundo a por qué Aylien se desempeña tan bien en esta búsqueda de prueba. La copia del sitio no es lo único que funciona bien, la URL contiene específicamente dos de nuestras palabras clave: "texto" y "análisis". Aunque Aylien ofrece diferentes servicios (dos API, aplicaciones y herramientas de editor), tienen páginas de inicio separadas para sus dos servicios API: API de análisis de texto y API de noticias .http://aylien.com/text-api

Separar las presencias de servicios con centros de desarrollo dedicados que utilizan URL simples y específicas es un impulso para el SEO. Esto es necesario para las suites de API que se adaptan a muchos servicios específicos, como Cognitive Services de Microsoft, una biblioteca de API de inteligencia artificial. La plataforma de datos del mercado financiero a pedido BarChart lleva esto incluso un paso más allá, aislando la documentación pública de cada parámetro de API en URL únicas .

Las páginas de inicio separadas para sus múltiples API ayudan a organizar la arquitectura del sitio y amplían el impacto de su contenido para aprovechar las palabras clave de enfoque específicas, lo que lo abre a una red más amplia de búsquedas. Las páginas de inicio por servicio también permiten un espacio para presentar tecnología a los no desarrolladores ; Un buen ejemplo de esto es Pitney Bowes Developer Hub : para cada API individual tienen una página con una copia detallada y un video muy accesible que comunica la propuesta de valor para la función específica.

Sin embargo, no empuje la segmentación de la documentación real demasiado lejos, o corre el riesgo de una disminución en la usabilidad y la experiencia del desarrollador.

Esta en el nombre

Esto puede parecer obvio, pero elegir el nombre correcto del producto es crucial. Una empresa centrada en API que promueve un solo producto tiene la ventaja de vincular la funcionalidad de nicho en una sola imagen de marca: Wit.ai, por ejemplo, usa el acrónimo de Inteligencia Artificial (AI) dentro de su nombre y extensión de dominio. Sin embargo, las empresas de tecnología más grandes deben dividir múltiples identidades de marca bajo un mismo techo, aumentando así la importancia del nombre de producto y la identidad de servicio específicos.

También aumente sus intentos de marketing de API al comprender a su consumidor desarrollador único

Hoja de referencia de más de 10 directorios de API para enviar su API

Está bien. Ahora tenemos una buena idea para refinar la identidad y el copy de la marca. Lo siguiente es asegurarse de que su API esté representada en los siguientes directorios para que los desarrolladores que utilizan recursos distintos de Google puedan encontrarlos. No tenemos cifras sobre el tráfico de estos sitios, pero como enviar perfiles es un proceso relativamente sencillo, parece que vale la pena aumentar la visibilidad de su API.

Web programable

ProgrammableWeb es un excelente sitio a seguir para las nuevas versiones de API y para buscar API. Si desea dirigirse a desarrolladores que buscan una tecnología como la suya, esta es una primera parada sólida. Lo que hace que ProgrammableWeb sea excelente es que están bastante abiertos a presentar contenido de la comunidad . Hay algunas cosas que puede hacer en su sitio:

  • ENVIAR un perfil para su API para agregarlo al directorio.
  • ENVIAR un perfil para su SDK . Esto también incluye bibliotecas auxiliares y / o ejemplos de código.
  • Si tiene un anuncio o comunicado de prensa, CONTACTE a los editores de PW.com .
  • También publican contenido patrocinado y colocan anuncios.

Mashape

Mashape es bien conocido por su portal de desarrolladores y sus servicios de análisis para API y microservicios. Incluso si no está utilizando sus herramientas de administración, aún puede incluir su API en PublicAPIs.com , su extenso mercado:

  • AÑADA su perfil de API a PublicAPIs.comPublicAPIs com
  • PUBLICAR su API con la red Mashape

apis.guru-nordicapis
APIs.guru

APIs.guru se está convirtiendo en la Wikipedia de código abierto para API. Dado que el directorio es de código abierto, APIs.guru se ha integrado con Any-API, SDKs.io, Cenit.io y otro software de código abierto, lo que significa que esto podría exponerlo a una amplia red de desarrolladores de software. Cualquiera puede agregar o cambiar una API:

  • Utilice el formulario APIs.guru para AGREGAR su API
  • CONTRIBUYE a este proyecto en GitHub

Otros lugares donde puede incluir su API:

  • Exicon : AÑADA su API a su directorio en "cuestión de minutos".
  • API para eso : ENVIAR un perfil a este directorio de API pequeño pero curado.
  • IBM API Harmony : ENVÍE su API para su revisión con la colección seleccionada de terceros de IBM.
  • API sueca Directorio por Mashup.se : ENVIAR su API para el catálogo API sueca mantenido por Andreas Krohn / Dopter.se. ¡Tenga en cuenta que todo está en sueco!
  • SDKs.io : agregue su SDK a esta colección de kits de desarrollo de software.
  • APIs.io : Crear un archivo APIs.json y registrar su API con APIs.io . (Explicaremos por qué a continuación)
  • Registro de cambios de API:  solicite una API  con este sitio de supervisión de API para que sus consumidores de API tengan actualizaciones automáticas cuando cambien sus documentos.
  • Hitch hq  ayuda a los proveedores de API a hacer crecer su comunidad y hacer que su plataforma sea más visible. Tienen una lista cada vez mayor de API y los proveedores pueden registrarse con ellos para agregar su API a la lista.
  • RapidAPI: sugiera que su API se agregue a este creciente mercado de API aquí .
  • ¿Más? : Póngase en contacto con nosotros o comente a continuación para ampliar esta lista.

Los dos siguientes no son exactamente directorios de API, pero son inteligentes para considerarlos como parte de una estrategia de promoción para aplicaciones web que tienen API.

IFTTT

If This Then That (IFTTT) es una plataforma donde los usuarios pueden establecer activadores entre aplicaciones web; si algo sucede en una aplicación, influirá en una función en otra aplicación. Lo bueno es que IFTTT acepta solicitudes para crear un nuevo canal en su plataforma si su aplicación tiene una API pública. Si desea mostrar su funcionalidad y marca a quienes no son desarrolladores, esta podría ser una buena salida:

  • ENVIAR una solicitud de canal con IFTTT.

Zapier

Zapier es igualmente una plataforma en la que los usuarios pueden crear brebajes elaborados en casa para automatizar el intercambio de datos entre varias aplicaciones web. Si desea enviar su aplicación al mercado de Zapier, en realidad es posible:

  • Agregue su aplicación a Zapier si tiene una API basada en REST o XML-RPC.

En nuestro último artículo sobre el descubrimiento de API, enumeramos 11 formas de encontrar API desde la perspectiva del desarrollador . Sin embargo, tenga en cuenta que no todos esos directorios de API le permiten enviar perfiles; algunos son consolas de búsqueda para redes de administración de API como Apigee o Mashery . Otras son colecciones de API propietarias (biblioteca de IBM, servicio de descubrimiento de Google, etc.). Por lo tanto, en este artículo hemos enumerado las redes a las que cualquier proveedor de API podría enviar.

Automatización de descubrimiento de servicios

El descubrimiento de API es la suma total de procesos que utiliza un desarrollador para buscar, encontrar e investigar API. Como se describió anteriormente, esto generalmente comienza con una búsqueda en Google o mediante los directorios mencionados anteriormente. Pero la mayoría de las veces, los programas exitosos obtienen tracción con un poco de suerte y el boca a boca.

Después de que un desarrollador ha encontrado algunos servicios potenciales, todavía existen muchos factores que hacen que comparar API similares sea un asunto complejo. Los usuarios potenciales deben considerar aspectos como los costos de licencias, la limitación de tasas, los formatos de datos, las políticas de uso, los métodos de autorización y los tipos de documentación, y luego deben experimentar con la implementación y las pruebas reales del código antes de decidir qué servicio usar.

Bruno Pedro , especialista en API y cofundador de Hitch hq , ve todo el proceso de descubrimiento de API de la siguiente manera:

  1. Búsqueda inicial : Google, directorios.
  2. Documentación : comprensión de los parámetros de la API.
  3. Aprovisionamiento de usuarios : debe autorizar / autenticarse con el servicio por algún medio. SAML, OAuth , etc.
  4. Generación de código : el consumidor querrá trabajar con el lenguaje de su elección, por lo que los SDK y las bibliotecas listas para usar se generan a partir de la definición de API.
  5. Integración : una vez que la API se consume en la aplicación, se debe monitorear el tiempo de actividad y los cambios.

La pregunta es, ¿cómo podemos automatizar ciertas partes de este proceso de descubrimiento para facilitar la búsqueda del servicio adecuado? Como hemos descrito antes, existen soluciones para automatizar la generación de código , y también hay muchas soluciones de monitoreo de API en el mercado.

Pero los otros puntos no se automatizan tan fácilmente.

La esperanza es que mediante la creación de una lectura mecánica y consumibles meta formato para la descripción de las API, las máquinas se entienden fácilmente lo que una API es capaz de hacer, y será capaz de describir la documentación orientada hacia el ser humano, el precio, el proceso de registro, mecanismo de autorización, endpoints y más. Ahí es donde entra APIs.json , un proyecto que espera combinar estos elementos en un solo formato para hacer que todas las API sean más visibles .

APIs.json

El formato abierto APIs.json , compatible con 3scale y API Evangelist, es un formato emergente para describir las operaciones de API para permitir la detección automatizada por robots de software. La idea es novedosa porque es el primer enfoque para estandarizar los metadatos operativos de una API.

"Para cada API enumerada, le asigna un nombre, una descripción y propiedades de apoyo, que pueden ser tan simples como proporcionar un enlace a su documentación o tan complejas como proporcionar un enlace a una definición de API legible por máquina en Swagger o API Formato de plano ".

Apodado como un índice para las operaciones de API , APIs.json se puede considerar similar a cómo los sitios web usan un archivo sitemap.xml para describir la arquitectura del sitio.

Su archivo APIs.json debe residir en la raíz de su dominio. Tome la implementación en vivo actual de Fitbit como ejemplo. (Vea también una explicación detallada de dicho archivo Fitbit APIs.json aquí ). Una vez que se crea el archivo APIs.json, puede registrarlo con APIs.io , un motor de búsqueda de API de código abierto que actualmente enumera más de 1000 API.https://www.fitbit.com/apis.json

Fuera de APIs.io, APIs.json será una fuerza impulsora detrás de otros motores de búsqueda específicos de API y otros proyectos actualmente en desarrollo. Los consumidores también pueden crear archivos API.json para describir las API de terceros de las que dependen sus aplicaciones. Este ecosistema incluso permitirá que los intermediarios de API actúen como agregadores que ensamblen colecciones de múltiples API relevantes para industrias específicas.

El proyecto todavía está aceptando comentarios , pero a medida que más personas lo utilizan, parece posible una futura estandarización con un organismo como el W3C. Muchos creen que la indexación de las API mediante APIs.json permitirá que surjan nuevas herramientas y será un gran salto hacia la estandarización en el espacio de las API, así que diviértase ahora y no más tarde.

Más sobre promoción: describimos lo que se necesita para convertirse en un defensor de las API en nuestra publicación El día en la vida de un evangelista de las API

A continuación: ajuste preciso de un lanzamiento, relaciones con los desarrolladores y más

Aumentar la visibilidad de la presencia de su API es un primer paso importante para aumentar el impacto de su servicio. Pero, todavía hay muchas más vías, como organizar su propio hackathon o cumbre de desarrolladores, comunicarse con la prensa y publicar en redes como Product Hunt, o establecer relaciones de desarrollo de calidad con clientes existentes a través del correo electrónico, GitHub y foros para mantener un útil, Personaje transparente de la empresa. Mejorar su centro de desarrolladores con útiles tutoriales, un blog de publicación constante y más también aumenta la incorporación y la usabilidad. Aún queda mucho por cubrir cuando se trata de API Marketing , así que suscríbete a nuestro boletín mientras exploramos otras formas de impulsar la adopción en artículos futuros.

Publicar un comentario

0 Comentarios