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é envoie une requête HTTP à l’URL que vous indiquez, puis stocke la réponse afin que vous puissiez y faire référence avec Liquid. Ajoutez une étiquette {% connected_content %} à votre message, et Braze appelle l’endpoint au moment de l’envoi du message.
{% 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’usage courants
| Cas d’usage | Description |
|---|---|
| Recommandations produit | Récupérez des sélections de produits personnalisées à partir d’un moteur de recommandation |
| Prix ou stocks en temps réel | Affichez les prix actuels ou les niveaux de stock au moment de l’envoi |
| Contenu basé sur la météo | Récupérez les données météo locales pour adapter votre communication |
| Soldes de points de fidélité | Affichez les récompenses ou les soldes de compte à jour |
| Flux de contenu | Insérez les derniers articles de blog, articles ou actualités |
Authentification
Braze prend en charge l’authentification de base, l’authentification par jeton et OAuth pour les requêtes de contenu connecté. Vous pouvez stocker vos identifiants en toute sécurité dans le tableau de bord de Braze, sous Paramètres > Gestion des identifiants, puis 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 expire, Braze affiche une chaîne de caractères vide à la place de la réponse du contenu connecté. Pour détecter les échecs, vérifiez si la variable enregistrée est nulle, puis interrompez le message de manière conditionnelle ou affichez un contenu de secours.
Pour plus d’informations, consultez la section Interrompre le contenu connecté.
Considérations de performance
Comme Braze envoie des messages en grand volume, votre serveur doit pouvoir 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 afin d’éviter de surcharger les endpoints externes.
Pour consulter la référence complète sur le contenu connecté, consultez la page Contenu connecté.