¿Qué es una API? [Lectura rápida]

Si no es desarrollador, pero trabaja en tecnología, el término API probablemente sea algo que entienda en un sentido conversacional. Es probable que sepa lo que significa (interfaz de programación de aplicaciones), y tal vez sus equipos usen API para hacer su trabajo, o tal vez sea incluso el producto en sí (Twilio SendGrid, por ejemplo).

Pero, ¿qué es exactamente una API y cómo funciona?

Comprender los principios más profundos detrás de las API lo ayudará a comercializar, vender o utilizar mejor estas tecnologías usted mismo.

Esta publicación explica cómo funcionan las API, cómo las crean los desarrolladores y cómo usarlas (con ejemplos del mundo real).

¿Cómo funcionan las API?

La forma en que los navegadores web interactúan con los servidores es un principio fundamental de las API. La web es una colección de servidores remotos dispersos por todo el planeta. Cuando abre un navegador y escribe un sitio web, el navegador está haciendo una llamada al servidor del cliente (cualquiera que sea la aplicación o el servidor en el que esté alojado un sitio web) para buscar y mostrar lo que se encuentre en esa URL.

Si bien una API no es el servidor en sí, es la parte del servidor, conocida como punto final, que envía y recibe ciertas respuestas. Las API son una forma en que diferentes piezas de software se comunican (también conocido como envío y recepción) entre sí mediante la apertura de puntos finales.

Los desarrolladores configuran llamadas API para recuperar datos específicos necesarios para varios propósitos cuando están creando aplicaciones o sitios web. Por ejemplo:

• ¿Acabas de abrir tu aplicación de Instagram? Eso fue posible gracias a una llamada API.
• ¿Alguna vez ha agregado un evento a su Google Calendar desde otro sitio web o correo electrónico? Ese sitio estaba aprovechando la API de Google Calendar para obtener esa información específica del servidor de Google Calendar.

Conclusiones: los desarrolladores configuran llamadas API para recuperar tipos de datos específicos para mostrar lo que necesitan cuando un usuario está en un sitio web o ejecutando una aplicación.

El auge del descanso

Otro término que probablemente haya escuchado es API REST. No es diferente por decir que la definición tradicional de una API. Aún así, vale la pena entender por qué las API REST se han vuelto tan populares y qué las distingue de las demás.

Al principio, las API se crearon para cumplir con los requisitos de SOAP (Protocolo simple de acceso a objetos). Pero este método era un poco tedioso y requería mucho ancho de banda para transferir conjuntos de datos. También exigió mucha energía del desarrollador (no del tipo divertido). SOAP utiliza el lenguaje de marcado XML notoriamente pesado para mostrar datos. Útil para garantizar la compatibilidad universal, pero eso es todo.

Los desarrolladores buscaban formas más ligeras y flexibles de realizar llamadas API. Las API REST (transferencia de estado representacional) proporcionan una solución alternativa a la API SOAP. No están limitados por un protocolo específico, aunque deben cumplir con ciertos estilos arquitectónicos (si está interesado en profundizar en eso, diríjase aquí).

En lugar de mostrarse con marcado XML, el servidor utiliza el lenguaje ligero JSON (solo archivos de texto). Las API REST tienen un ancho de banda mucho más ligero que SOAP (por lo general, solo son una URL) y, naturalmente, están optimizadas para la comunicación en la web.

Para llevar: Piense en las API REST como el Marie Kondo de los datos. Toman y usan solo *precisamente* lo que necesitan. Las API de SOAP son como el garaje de su vecino que actualmente está repleto de papel higiénico.

Comprender los diferentes tipos de API

Independientemente del protocolo o estilo que siga una API, existen varios tipos de API, entre ellos:

• API abiertas : también conocidas como API públicas, cualquier desarrollador puede acceder a estos puntos finales y, por lo general, no imponen ninguna restricción al usuario. Normalmente aceptan donaciones.
• API de socios : estas son API que están diseñadas para usarse juntas y, por lo general, solo se puede acceder a ellas mediante algún tipo de mercado.
• API internas : estas son herramientas internas que las empresas utilizan para ayudar a sus empleados a ser más eficientes o proporcionar una forma más segura para que los empleados compartan datos/información.
• API compuestas : las API compuestas son una forma de consolidar las llamadas de API que están relacionadas pero que normalmente requerirían llamadas de API individuales.

Ejemplos de la vida real de API

Hay un montón de API disponibles (algunas cuentan con más de 15 000) que ayudan a los usuarios a acceder a diversas aplicaciones. A continuación se presentan algunos notables que lo ayudarán a comprender el alcance del ecosistema API.

El Cóctel DB

Supongamos que tiene una licorería local y desea ofrecer recetas de cócteles en su sitio web. Podría considerar usar la API Cocktail DB anterior. Todos esos datos (las recetas de cócteles) ya existen en el servidor de otra persona y se pueden evaluar a través de la API.

Cuando un usuario hace clic en las recetas de margaritas (posiblemente el cóctel superior), sus servidores encuentran que la receta específica la envía en JSON, se recoge en el sitio web y se analiza en HTML y CSS para que esté presentable en el navegador de su sitio web.

OpenWeatherMap

Agregar una sección meteorológica a su sitio web es un caso de uso muy común. Piense en cualquier estación de esquí, tiendas de bicicletas o empresa de turismo. La API de OpenWeatherMap almacena todas las previsiones meteorológicas y la información y muestra solo la parte que está solicitando.

Esta API proporciona versiones gratuitas y premium según la cantidad de datos que desee mostrar.

API de correo electrónico SendGrid

La API de correo electrónico de SendGrid aprovecha SMTP (protocolo simple de transferencia de correo) para permitir a los clientes enviar grandes cantidades de correos electrónicos transaccionales y activados, como restablecimientos de contraseña, confirmación de cuenta y notificaciones de envío.

Twilio SMS

La API de Twilio SMS es otra API REST que proporciona una forma de agregar funciones de mensajería a las aplicaciones. La mensajería SMS se ha vuelto cada vez más popular como una forma en que las marcas se comunican con los clientes porque es personal, en tiempo real, y estos mensajes se leen a tasas mucho más altas.

Cómo usar una API

Antes de que usted o su equipo comiencen a usar las API, es importante saber si son abiertas, si se usan junto con un servicio de socios o un compuesto.

Cómo empezar con una API

Lea la documentación. Cualquier API debe tener documentación aplicable para que la siga. Le dirá qué dependencias tiene, qué tipo de API es y cómo usarla. La documentación deficiente debería ser una señal de alerta para usted y su desarrollador. Estamos muy orgullosos de la excelente documentación de Twilio y SendGrid.

Genere una clave API. Deberá generar una clave API para comenzar a usarla. Aquí hay instrucciones de la API de Google Maps:

Nota : nunca comparta claves API y asegúrese de que no estén visibles en ningún código público que coloque en GitHub.

Comience a construir: envíe correos electrónicos gratis con la API de correo electrónico de SendGrid

¡El resto depende de usted! Las oportunidades son realmente infinitas cuando trabaja con API. Para ver todas las oportunidades de trabajar con la API de Twilio, consulte Twilio Code Exchange.

Si está interesado en usar la API de correo electrónico de SendGrid para enviar correos electrónicos gratuitos, échale un vistazo aquí.