Primeros pasos con las interfaz de programación de aplicaciones (API) de Klaviyo
Objetivos del artículo
Obtén una comprensión básica de las llamadas a la interfaz de programación de aplicaciones (API) y de cómo las interfaz de programación de aplicaciones (API) de Klaviyo pueden beneficiar a tu empresa. En esta guía, aprenderás sobre las interfaces de programación de aplicaciones (API) REST, los métodos HTTP y las herramientas para desarrolladores para prepararte para probar la interfaz de programación de aplicaciones (API) de Klaviyo. Tus primeras llamadas a la interfaz de programación de aplicaciones (API) se pueden realizar en tan solo 10 minutos de principio a fin. Si ya estás familiarizado con las llamadas a la interfaz de programación de aplicaciones (API) y estás listo para probar nuestras interfaz de programación de aplicaciones (API), sigue nuestra guía sobre cómo usar nuestras colecciones de Postman.
A lo largo de esta guía, enlazaremos a un glosario cuando se introduzcan nuevos términos técnicos. Si en algún momento de la guía no tienes claro el significado de una palabra, consulta el glosario de términos técnicos.
¿Qué es una interfaz de programación de aplicaciones (API) REST?
La REST interfaz de programación de aplicaciones (API) es un conjunto de acrónimos que significan Representational State Transfer e interfaz de programación de aplicaciones (API). Estos términos se pueden entender más fácilmente como solicitudes estructuradas que permiten que un software se comunique con otro y transfiera información entre ellos. Cuando haces una llamada a una interfaz de programación de aplicaciones (API), envías una solicitud a un servidor donde se almacena la información, y luego este devuelve una respuesta con los datos solicitados en formato JSON, o JavaScript Object Notation.
En pocas palabras, las interfaz de programación de aplicaciones (API) REST te permiten solicitar almacenamiento de datos en Klaviyo y recibir esos datos en un formato legible para ti y para las computadoras.
Una llamada a la interfaz de programación de aplicaciones (API) estándar sucede en segundos. Detrás de escena, tu llamada:
- Envía una solicitud estructurada de datos a través de internet a la interfaz de programación de aplicaciones (API). Las solicitudes se envían mediante HTTP, un tipo básico de solicitud de red en el que se basa gran parte de internet.
- La interfaz de programación de aplicaciones (API) recibirá la solicitud, la procesará y obtendrá la información solicitada de las bases de datos de Klaviyo.
- Luego, la interfaz de programación de aplicaciones (API) responde a la aplicación cliente mediante un formato estructurado en JSON.
- Recibirás la respuesta JSON de la aplicación cliente.
Aunque este conocimiento es útil para entender cómo funciona la transferencia de datos, no es necesario para empezar a hacer llamadas a la interfaz de programación de aplicaciones (API) y obtener valor de lo que ofrecen las interfaz de programación de aplicaciones (API) de Klaviyo. Todo lo que necesitas saber para comenzar con tus primeras llamadas a la interfaz de programación de aplicaciones (API) se cubrirá en las siguientes secciones.
Métodos HTTP
Los métodos HTTP son los "verbos" mediante los cuales se envían tus solicitudes. En esta guía abordaremos 2 métodos HTTP: GET y POST.
Aunque no los usaremos aquí, vale la pena señalar que la mayoría de las interfaz de programación de aplicaciones (API) REST admiten métodos HTTP adicionales, como PUT, PATCH y DELETE.
GET
Una solicitud GET se entiende más fácilmente como una solicitud de "lectura". Las solicitudes GET recuperan información del punto de conexión de la interfaz de programación de aplicaciones (API) endpoint y te la devuelven en una respuesta con formato JSON. Estas solicitudes solo te permiten leer datos, lo que las convierte en el tipo de solicitud más seguro porque tus datos no pueden modificarse ni sobrescribirse con este método.
POST
Una solicitud POST se puede entender simplemente como una solicitud de “escritura”. POST te permite crear o agregar nuevos recursos. Por ejemplo, una solicitud POST a la interfaz de programación de aplicaciones (API) de listas se puede usar para crear una nueva lista en tu cuenta, mientras que una solicitud GET se puede usar para recuperar todas las listas disponibles. Ten en cuenta que, al publicar datos, las respuestas variarán según cuándo Klaviyo pueda completar tu solicitud.
Herramientas necesarias
Las interfaces de programación de aplicaciones (API) ofrecen mucha flexibilidad a los flujos de trabajo y no requieren que uses una aplicación cliente específica ni una biblioteca de lenguaje para lograr los resultados deseados. Como las llamadas a la interfaz de programación de aplicaciones (API) se realizan mediante solicitudes HTTP, casi cualquier lenguaje de programación puede enviar este tipo de solicitud de forma nativa o mediante una biblioteca de lenguaje ampliamente disponible. Además, según tu máquina y sistema operativo, puedes usar aplicaciones nativas como Terminal de Apple o la línea de comandos de Windows para hacer llamadas a la interfaz de programación de aplicaciones (API) del lado del cliente. Sin embargo, estas aplicaciones requieren conocimientos previos de interfaces de línea de comandos.
Usamos una aplicación web y de escritorio gratuita llamada Postman. Postman tiene una variedad de funciones que facilitan configurar y enviar una solicitud de interfaz de programación de aplicaciones (API) al ingresar el punto de conexión, los parámetros y la autenticación en una interfaz de usuario útil.
Prueba las interfaz de programación de aplicaciones (API) de Klaviyo
Las interfaz de programación de aplicaciones (API) de Klaviyo son útiles para enviar datos desde otras plataformas o servidores a cuentas de Klaviyo o consultar información dentro de una cuenta de Klaviyo. Ahora que ya sabes cómo funcionan las interfaz de programación de aplicaciones (API), puedes empezar a probar nuestras interfaz de programación de aplicaciones (API) para los casos de uso de tu empresa. Para ver una lista completa de las interfaz de programación de aplicaciones (API) disponibles de Klaviyo, consulta nuestra documentación de referencia de la interfaz de programación de aplicaciones (API). Sigue nuestra guía sobre cómo usar nuestras colecciones de Postman para hacer tu primera llamada a la interfaz de programación de aplicaciones (API) de Klaviyo.
Recursos adicionales
Recursos del portal para desarrolladores
El portal para desarrolladores de Klaviyo contiene guías de la interfaz de programación de aplicaciones (API) y documentación de referencia para ayudarte a aprovechar al máximo nuestras interfaz de programación de aplicaciones (API). Consulta los recursos a continuación para comenzar:
- Documentación de referencia de la interfaz de programación de aplicaciones (API) de Klaviyo
- Primeros pasos con la interfaz de programación de aplicaciones (API) de Javascript
- Configuración de eventos transaccionales basados en la interfaz de programación de aplicaciones (API)
Cursos de Klaviyo para desarrolladores
Klaviyo Academy ofrece cursos para desarrolladores que te ayudan a comenzar a crear con las interfaz de programación de aplicaciones (API) de Klaviyo. Consulta los cursos a continuación: