API REST
Extrayez des données d’API REST externes directement dans vos messages au moment de l’envoi grâce au Contenu connecté. Vous pouvez ainsi personnaliser vos messages avec des informations en temps réel provenant de vos propres serveurs, de services tiers ou de tout endpoint d’API accessible publiquement.
Fonctionnement
Le Contenu connecté effectue une requête HTTP vers l’URL que vous spécifiez, puis stocke la réponse afin que vous puissiez la référencer avec Liquid. Ajoutez une balise {% connected_content %} à votre message, et Braze appelle l’endpoint au moment de l’envoi du message.
1
2
{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!
Le Contenu connecté prend en charge les requêtes GET et POST. Braze exige que le serveur réponde dans un délai de deux secondes ; concevez donc vos endpoints pour une faible latence.
Cas d’utilisation courants
| Cas d’utilisation | Description |
|---|---|
| Recommandations produit | Récupérer des suggestions de produits personnalisées depuis un moteur de recommandation |
| Tarifs ou inventaire en temps réel | Afficher les prix actuels ou les niveaux de stock au moment de l’envoi |
| Contenu basé sur la météo | Extraire les données météo locales pour adapter les messages |
| Soldes de points de fidélité | Afficher les récompenses ou soldes de compte à jour |
| Flux de contenu | Insérer les derniers articles de blog, publications ou actualités |
Authentification
Braze prend en charge l’authentification basique, l’authentification par jeton et OAuth pour les requêtes de Contenu connecté. Vous pouvez stocker vos identifiants de manière sécurisée dans le tableau de bord de Braze sous Paramètres > Contenu connecté et les référencer dans vos appels API.
Pour en savoir plus, consultez Effectuer un appel API de Contenu connecté.
Gestion des erreurs
Si l’endpoint renvoie une erreur ou dépasse le délai d’attente, Braze affiche une chaîne de caractères vide à la place de la réponse du Contenu connecté. Vous pouvez détecter les échecs en vérifiant si la variable enregistrée est nulle, puis annuler conditionnellement le message ou afficher un contenu de secours.
Pour en savoir plus, consultez Annuler le Contenu connecté.
Considérations de performance
Étant donné que Braze envoie des messages en très grand volume, votre serveur doit être capable de gérer des milliers de connexions simultanées. Utilisez la mise en cache lorsque c’est pertinent et définissez des limites de débit sur vos messages pour éviter de surcharger les endpoints externes.
Pour la référence complète du Contenu connecté, consultez Contenu connecté.