Primeros pasos con las API de Klaviyo

Qué aprenderás

Obtenga una comprensión básica de las llamadas API y de cómo las API de Klaviyo pueden beneficiar a su negocio.  En esta guía, aprenderá sobre las API REST, los métodos HTTP y las herramientas para desarrolladores que le prepararán para probar las API de Klaviyo. Sus primeras llamadas a la API pueden realizarse en tan sólo 10 minutos de principio a fin. Si ya está familiarizado con las llamadas a la API y está listo para probar nuestras API, siga nuestra guía sobre cómo utilizar nuestras colecciones Postman.

¿Qué es una API REST?

REST API es un conjunto de siglas que significan Transferencia de Estado Representacional e Interfaz de Programación de Aplicaciones. Estos términos pueden entenderse más sencillamente como peticiones estructuradas que permiten a una pieza de software hablar con otra y pasar información entre ellas. Cuando realiza una llamada a una API, está enviando una solicitud a un servidor en el que se almacena información, que a su vez devuelve una respuesta con los datos solicitados en formato JSON, o JavaScript Object Notation.

Más sencillamente, las API REST le permiten solicitar datos almacenados en Klaviyo y que esos datos le sean devueltos en un formato legible por usted y por los ordenadores. 

Una llamada estándar a la API se produce en cuestión de segundos. Entre bastidores, su llamada

1. Envíe una solicitud estructurada de datos a través de Internet a la API. Las solicitudes se envían a través de HTTP, un tipo de solicitud de red básico en torno al cual se construye en gran medida Internet.
2. La API recibirá la solicitud, la procesará y obtendrá la información solicitada de las bases de datos de Klaviyo.
3. A continuación, la API responde a la aplicación cliente utilizando el formato estructurado JSON.
4. Recibirá la respuesta JSON de su 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 API y obtener valor de lo que las APIs de Klaviyo tienen que ofrecer. Todo lo que necesita saber para empezar con sus primeras llamadas a la API se tratará en las siguientes secciones.

Métodos HTTP

Los métodos HTTP son los "verbos" mediante los cuales se envían sus peticiones. Hay dos métodos HTTP que trataremos en esta guía: GET y POST.  

GET

Una solicitud GET puede entenderse más fácilmente como una solicitud de "lectura". Las solicitudes GET recuperan información del punto final de la API y se la devuelven en una respuesta con formato JSON. Estas peticiones sólo le permiten leer datos, lo que las convierte en el tipo de petición más seguro, ya que sus datos no pueden modificarse ni sobrescribirse con este método.

POST

Una solicitud POST puede entenderse simplemente como una solicitud de "escritura". POST le permite crear o añadir nuevos recursos. Por ejemplo, una solicitud POST a la API de listas puede utilizarse para crear una nueva lista en su cuenta, mientras que una solicitud GET puede utilizarse para recuperar todas las listas disponibles. Tenga en cuenta que, al publicar datos, las respuestas variarán en función del momento en que Klaviyo pueda completar su solicitud.

Herramientas necesarias

Las API ofrecen mucha flexibilidad a sus flujos de trabajo y no le obligan a utilizar una aplicación cliente o una biblioteca de lenguajes específica para lograr los resultados deseados. Dado que las llamadas a la API se realizan mediante peticiones HTTP, casi todos los lenguajes de programación tienen la capacidad de enviar este tipo de peticiones de forma nativa o a través de una biblioteca de lenguaje ampliamente disponible. Además, dependiendo de su máquina y sistema operativo, puede utilizar aplicaciones nativas como el Terminal de Apple o la Línea de comandos de Windows para realizar llamadas a la API del lado del cliente. Sin embargo, estas aplicaciones requieren un conocimiento previo de las interfaces de línea de comandos.

Utilizamos una aplicación web y de escritorio gratuita llamada Postman.  Postman cuenta con una serie de funciones que facilitan la configuración y el envío de una solicitud de API introduciendo el punto final, los parámetros y la autenticación en una interfaz de usuario muy útil.

Pruebe las API de Klaviyo

Las API de Klaviyo son útiles para enviar datos desde otras plataformas o servidores a cuentas de Klaviyo o para consultar información dentro de una cuenta de Klaviyo. Ahora que comprende cómo funcionan las API, puede empezar a probar nuestras API para los casos de uso de su empresa. Para obtener una lista completa de las API disponibles de Klaviyo, consulte nuestra documentación de referencia de API. Siga nuestra guía sobre cómo utilizar nuestras colecciones Postman para realizar su primera llamada a la API de Klaviyo.

Recursos adicionales

Recursos del portal para desarrolladores

El portal para desarrolladores de Klaviyo contiene guías de API y documentación de referencia para ayudarle a sacar el máximo partido de nuestras API. Consulte los siguientes recursos para empezar:

• Documentación de referencia de la API de Klaviyo
• Introducción a la API Javascript
• Configuración de eventos transaccionales basados en API

Cursos para desarrolladores de Klaviyo

La Academia Klaviyo ofrece cursos para desarrolladores que le ayudarán a empezar a construir con las APIs de Klaviyo. Consulte los cursos a continuación:

• Certificado de desarrollador de Klaviyo
• Definir los términos comunes de la API
• Adquiera conocimientos básicos sobre las API
• Mapee sus datos en Klaviyo