Démarrer avec les API de Klaviyo

Vous apprendrez

Obtenez une compréhension fondamentale des appels API et de la façon dont les API de Klaviyo peuvent profiter à votre entreprise.  Dans ce guide, vous découvrirez les API REST, les méthodes HTTP et les outils de développement pour vous préparer à tester les API de Klaviyo. Vos premiers appels à l'API peuvent être effectués en seulement 10 minutes, du début à la fin. Si vous êtes déjà familiarisé avec les appels d'API et que vous êtes prêt à tester nos API, suivez notre guide sur l'utilisation de nos collections Postman.

Qu'est-ce qu'une API REST ?

REST API est un ensemble d'acronymes qui signifient Representational State Transfer et Application Programming Interface. Ces termes peuvent être compris plus simplement comme des requêtes structurées qui permettent à un logiciel de communiquer avec un autre et de transmettre des informations entre eux. Lorsque vous faites un appel API, vous soumettez une demande à un serveur où des informations sont stockées, qui renvoie ensuite une réponse contenant les données demandées au format JSON (JavaScript Object Notation).

Plus simplement, les API REST vous permettent de demander des données stockées dans Klaviyo et de les recevoir dans un format lisible par vous et par les ordinateurs. 

Un appel API standard se fait en quelques secondes. En coulisses, votre appel sera :

1. Envoyez une demande structurée de données à l'API via l'internet. Les demandes sont envoyées via HTTP, un type de demande de réseau de base sur lequel l'internet est largement construit.
2. L'API recevra la demande, la traitera et obtiendra les informations demandées dans les bases de données de Klaviyo.
3. L'API répond ensuite à l'application cliente en utilisant le format structuré JSON.
4. Vous recevrez la réponse JSON de votre application client.

Bien que ces connaissances soient utiles pour comprendre le fonctionnement du transfert de données, elles ne sont pas nécessaires pour commencer à effectuer des appels API et à tirer parti de ce que les API de Klaviyo ont à offrir. Tout ce que vous devez savoir pour commencer à effectuer vos premiers appels à l'API est abordé dans les sections suivantes.

Méthodes HTTP

Les méthodes HTTP sont les "verbes" par lesquels vos demandes sont envoyées. Nous aborderons deux méthodes HTTP dans ce guide : GET et POST.  

GET

Une demande GET peut être facilement comprise comme une demande de "lecture". Les requêtes GET récupèrent des informations à partir du point de terminaison de l'API et vous les renvoient dans une réponse au format JSON. Ces demandes vous permettent uniquement de lire des données, ce qui en fait le type de demande le plus sûr car vos données ne peuvent pas être modifiées ou écrasées avec cette méthode.

POST

Une requête POST peut être simplement comprise comme une requête "d'écriture". POST vous permet de créer ou d'ajouter de nouvelles ressources. Par exemple, une requête POST à l'API Liste peut être utilisée pour créer une nouvelle liste dans votre compte, tandis qu'une requête GET peut être utilisée pour récupérer toutes les listes disponibles. Notez que, lorsque vous publiez des données, les réponses varient en fonction du moment où Klaviyo peut répondre à votre demande.

Outils nécessaires

Les API offrent une grande souplesse à vos flux de travail et ne vous obligent pas à utiliser une application client ou une bibliothèque linguistique spécifique pour obtenir les résultats souhaités. Comme les appels API sont effectués au moyen de requêtes HTTP, presque tous les langages de programmation ont la capacité d'envoyer ce type de requête en mode natif ou par l'intermédiaire d'une bibliothèque de langage largement disponible. En outre, selon votre machine et votre système d'exploitation, vous pouvez utiliser des applications natives telles que Terminal d'Apple ou Windows Command Line pour effectuer des appels API côté client. Toutefois, ces applications nécessitent une connaissance préalable des interfaces de ligne de commande.

Nous utilisons une application web et de bureau gratuite appelée Postman.  Postman dispose d'une variété de fonctionnalités qui facilitent la mise en place et l'envoi d'une requête API en saisissant le point de terminaison, les paramètres et l'authentification dans une interface utilisateur utile.

Testez les API de Klaviyo

Les API de Klaviyo sont utiles pour envoyer des données d'autres plateformes ou serveurs vers des comptes Klaviyo ou pour interroger des informations au sein d'un compte Klaviyo. Maintenant que vous avez compris le fonctionnement des API, vous pouvez commencer à tester nos API pour les cas d'utilisation de votre entreprise. Pour une liste complète des API disponibles chez Klaviyo, consultez notre documentation de référence sur les API. Suivez notre guide sur l'utilisation de nos collections Postman pour effectuer votre premier appel à l'API Klaviyo.

Ressources complémentaires

Ressources du portail des développeurs

Le portail des développeurs de Klaviyo contient des guides d'API et de la documentation de référence pour vous aider à tirer le meilleur parti de nos API. Consultez les ressources ci-dessous pour commencer :

• Documentation de référence de l'API Klaviyo
• Démarrer avec l'API Javascript
• Mise en place d'événements transactionnels basés sur l'API

Cours pour développeurs Klaviyo

L'Académie Klaviyo propose des cours pour développeurs afin de vous aider à commencer à construire avec les API de Klaviyo. Consultez les cours ci-dessous :

• Certificat de développeur Klaviyo
• Définir les termes courants de l'API
• Construire une connaissance fondamentale de l'API
• Cartographier vos données dans Klaviyo