Cuando la industria del marketing cambió por primera vez del marketing saliente al inbound marketing, muchos especialistas en marketing abandonaron sus antiguos roles de interruptores de contenido por otros nuevos como creadores de contenido.
Pero ese cambio todavía está produciendo réplicas, y para mantenerse al día con sus competidores hoy, necesita comprender qué son las API, cómo se integran con su estrategia de contenido y la información social que aportan a su sitio web.
No se preocupe, las API pueden parecer complicadas, pero al final de esta publicación, sabrá cómo funcionan y qué implica su uso.Aquí hay una breve definición de una API, seguida de información clave sobre cómo hacer que una funcione para su negocio.
¿Qué es una API?
Una API, abreviatura de interfaz de programación de aplicaciones, es una serie de reglas. Para ser aún más claro, es un intermediario de información. Las API permiten que una aplicación extraiga información de un software y utilice esa información en su propia aplicación o, a veces, para el análisis de datos.
En términos más sencillos, una API es un modelo que permite que «sus cosas» hablen y trabajen con «sus cosas». Sus cosas, en este caso, se conocen como el punto final de la API.
¿Qué es un punto final de API?
Un punto final de API es el destino digital donde las API envían solicitudes de información desde una aplicación web o servidor y donde reciben una respuesta y acceden a los recursos necesarios para llevar a cabo su función.
¿Suena confuso? No se preocupe, veremos un ejemplo a continuación.
Ejemplo de punto final de API
Supongamos que desea transmitir tweets públicos en tiempo real para poder mantenerse informado sobre un tema específico de interés o sobre las tendencias actuales en el mundo. Entonces podrías usar Punto final de transmisión filtrada de Twitter. Su URL es: https://api.twitter.com/2/tweets/search/stream
Técnicamente, solo es necesario hacer referencia a un punto final de API con la ruta final de la URL del recurso. La ruta base, que es común a todos los puntos finales, es https://api.twitter.com. Debido a que sigue siendo el mismo, no es necesario seguir enumerándolo. En su lugar, puede simplemente enumerar el punto final: / 2 / tweets / search / stream.
Cómo probar un punto final de API
Hay varias herramientas en línea disponibles para probar un punto final de API. Por el bien de esta publicación, veremos cómo configurar una prueba usando cURL. cURL es una herramienta de línea de comandos para transferir datos que admite múltiples protocolos, incluido HTTP. Puede realizar solicitudes, obtener datos y enviar datos, lo que la convierte en la herramienta perfecta para solicitar información de las API.
Usemos un ejemplo de Documentación propia de Twitter. Digamos que desea mantenerse informado sobre la API de Twitter. Entonces querrás recibir tweets de cuentas importantes como @TwitterDev y @TwitterAPI tan pronto como se publiquen. Y tal vez solo desee tweets que contengan enlaces a artículos o documentación para obtener el mayor contexto posible.
En ese caso, usar el punto final de la secuencia filtrada es la elección perfecta. Pero para que el endpoint sepa qué tipo de tweets enviarle, deberá definir criterios de filtrado. De lo contrario, solo estaría pidiendo ver cada tweet publicado en tiempo real.
Los criterios de filtrado se aplicarán al punto final en forma de reglas. Para crear estas reglas, necesitará un conjunto de operadores. Para este ejemplo, puede utilizar dos operadores: desde: y tiene: enlaces – para ver solo los tweets de determinadas cuentas y que contienen enlaces. Para indicar al punto final de la transmisión filtrada que solo muestre los tweets de las cuentas @Twitterdev y @TwitterApi que contienen enlaces, usaría la siguiente regla: «De: twitterdev de: twitterapi tiene: enlaces»
Para solicitar esta información del punto final de la secuencia filtrada, debe incluir la solicitud HTTP correcta para indicarle a la API qué acción tomar. Hay cuatro opciones principales. Eche un vistazo a una breve descripción de cada uno a continuación:
- OBTENER: recuperar un recurso
- POST: crea un recurso
- PUT: actualizar un recurso existente
- BORRAR: eliminar un recurso
Para este ejemplo, usará la solicitud POST. Además de incluir la regla mencionada anteriormente en su solicitud, incluirá el tipo de contenido y la autorización. A continuación, el tipo de contenido se define como «aplicación / json», por lo que la solicitud se representa en el formato de datos ligero JavaScript Object Notation (JSON). Para autenticar su solicitud, deberá reemplazar el texto del marcador de posición $ BEARER_TOKEN con el código exclusivo de su aplicación. Token de portador, que se puede generar en su portal de desarrolladores.
curl -X POST 'https://api.twitter.com/2/tweets/search/stream/rules'
-H "Content-type: application/json"
-H "Authorization: Bearer $BEARER_TOKEN" -d
'{
"add": [
{"value": "from:twitterdev from:twitterapi has:links"}
]
}'
¿Por qué son importantes las API?
Una de las primeras preguntas que se hacen muchos especialistas en marketing es: ¿Por qué todas estas empresas comparten sus datos de forma abierta y gratuita?
Normalmente, la respuesta es: escala. A medida que las empresas de software crecen, el personal de esas empresas se da cuenta rápidamente de que tienen más ideas que tiempo y recursos para desarrollarlas.
Al crear API, las empresas permiten que los desarrolladores externos creen aplicaciones que pueden mejorar el uso y la adopción de la plataforma principal. De esa manera, una empresa puede construir un ecosistema que se vuelva dependiente de los datos de su API, una dinámica que a menudo genera oportunidades de ingresos adicionales.
Cómo utilizar una API
Comprender el valor de una API en particular se trata esencialmente de comprender qué información está disponible a través de una API y cómo se puede acceder a ella. Para saber qué puede hacer una API en particular por usted, puede hacer una de dos cosas.
- Pídale a un desarrollador web que mire una API y la discuta con usted.
- Haga la investigación por su cuenta. Si no tiene acceso o presupuesto para usar un desarrollador web, esta es una opción atractiva. Pero no se asuste: muchos servicios en línea tienen una buena documentación de API.
Documentación de API
Echemos un vistazo rápido a Índice de referencia de la API de Twitter como ejemplo.
Gran parte del crecimiento de Twitter se ha debido a desarrolladores externos, y la primera API de Twitter comenzó como una wiki básica. Desde entonces, se ha convertido en un detallado índice de API que un experto en marketing puede utilizar para determinar qué información podría estar disponible para un desarrollador en forma de API – y cómo incluir esta API en su sitio web.
Al mirar la captura de pantalla anterior, puede ver que hay varias categorías de información disponibles para desarrolladores externos. Una vez que seleccione una API que le interese, puede hacer clic en ella para ver qué información está disponible a través de esta API. Revisa Punto final de la API de la línea de tiempo de Tweet de Twitter abajo.
En la documentación de API anterior, la API de línea de tiempo de tweet de Twitter explica cómo puede tomar una breve colección de tweets recientes de la línea de tiempo de un usuario específico y mostrarlos, en un formulario en el que se puede hacer clic, en su propio sitio web. La documentación de la API incluye limitaciones de volumen de tweets, la URL de recursos de la API, así como lo que puede y no puede elegir mostrar a través de esta API.
Aplicación de la API a su sitio web
Si agrega la URL del recurso de la API al backend de su sitio web, devolverá la información que solicitó al frontend de su sitio web. Así es como se ve en el sitio web de New York Road Runners, ayudándoles a promocionar el Maratón de la ciudad de Nueva York (con algunas modificaciones de diseño personalizadas):
También puedes consultar la documentación de la API de HubSpot para ver cómo puedes crear aplicaciones e integraciones usando datos de HubSpot.
Una última advertencia: para poder utilizar oficialmente la API de un desarrollador, es posible que también deba tener asignada una clave API.
¿Qué es una clave de interfaz de programación de aplicaciones (API)?
Una clave de API es el identificador único asignado a un usuario de API, lo que indica que está autorizado a utilizar la interfaz de programación de aplicaciones en su sitio web. Muchos desarrolladores requieren que solicites esta clave antes de usar la API, mientras que otros pueden asignártela en tu primera solicitud de API.
Piense en su clave de API como su token de autenticación, que lo declara miembro de una comunidad de desarrolladores. En efecto, este token identifica para qué está utilizando la API y verifica que el propietario de la API le haya dado permiso para llevar a cabo este proyecto.
Tenga la seguridad de que su clave API no dar al desarrollador acceso a información personal sobre usted.
API como plataforma de marketing
El marketing en un mundo inbound se trata de empresas que desarrollan aplicaciones y servicios útiles para mantener la retención de clientes. Las marcas deberán dejar de colocar anuncios de forma intermitente para convertirse en conductos de comunicación con el consumidor.
En ese proceso, las API facilitan los datos necesarios para brindar soluciones a los problemas de los clientes.
Ejemplos de API
Comprender qué información está disponible a través de una API lo ayudará a determinar si vale la pena trabajar con un desarrollador para continuar con el proyecto. A continuación se muestran dos ejemplos.
Menciones de Twitter
Si desea mostrar tweets en su sitio web que incluyen menciones en Twitter a artículos de su blog, debe comprender si puede solicitar tweets solo con URL específicas de la API de Twitter.
Incorporación de videos de YouTube
Cuando haces clic con el botón derecho en un video de YouTube en youtube.com y seleccionas «Copiar código incrustado», básicamente estás solicitando usar la API de YouTube en tu sitio web. YouTube facilita al público la inserción de videos de YouTube para reproducirlos directamente en otros sitios web.
Condiciones de servicio de API
No importa el proyecto, es fundamental que realmente lea y comprenda los términos de servicio de una API que está considerando para su sitio web.
La mayoría de las API tienen ciertas restricciones de uso. Si no se toma el tiempo para comprender las restricciones de una API que le interesa, podría invertir más tiempo y dinero en desarrollar un activo de marketing que se vuelve inútil una vez que el proveedor de la API determina que ha violado los términos de servicio de la API. (y revoca su acceso).
Por esta razón, la mayoría de las API tienen «límites de llamadas».
¿Qué es una llamada API?
Una llamada a la API, también conocida como solicitud de API, es una instancia en la que el propietario de un sitio web «solicita» el uso de la API de un desarrollador. Guardar la API, los inicios de sesión en el sitio web del desarrollador y las consultas sobre la aplicación cuentan como llamadas a la API.
Teniendo esto en cuenta, un límite de llamadas a la API es la cantidad de veces que puede solicitar información sobre una API de un servicio web dentro de un período de tiempo determinado. Nuevamente, lea los términos de uso de cualquier API que esté pensando utilizar. Estos documentos deben detallar claramente cualquier limitación, así como el uso apropiado del programa.
El futuro de las API en los negocios
Desarrollar sobre las API de los servicios web existentes es solo el comienzo. Vivimos en un mundo que ahora espera contenido abierto y disponible para todos. – la progresión natural de esto es que los propios editores lancen sus propias API, de modo que su los clientes pueden desarrollar aplicaciones como resultado.
El uso compartido de API se aplica a todas las empresas, no solo a las que están basadas en la web, sino a cualquier persona que tenga una herramienta o un componente de su organización basada en la web. Obviamente, este concepto podría generar obstáculos para algunas organizaciones, especialmente del departamento legal. Depende de usted averiguar qué API son más valiosas y cómo puede usarlas de manera legal y sostenible.
Nota del editor: esta publicación se publicó originalmente en marzo de 2013 y se ha actualizado para que sea más completa.