Comment envoyer des enregistrements vers une source de données avec l'API Sendtric
Dernière mise à jour
Avec une source de données API, ton système envoie des enregistrements JSON à Sendtric dès que tes données changent. Sendtric les stocke sous forme de données hébergées, et tes images récupèrent l'enregistrement de chaque abonné lorsqu'un e-mail est ouvert.
Ce guide s'adresse à tous ceux qui écrivent le code permettant d'envoyer les données. Si tu préfères que Sendtric récupère les données depuis ton API à chaque ouverture, consulte comment connecter une source de données à ta propre API.
Créer la source de données
- Dans la barre latérale de gauche, clique sur Sources de données, puis Nouvelle source de données.
- Sous API, choisis API et clique sur Continuer.
- Choisis Envoyer les données à Sendtric puis clique sur Continuer.
- Remplis :
- Nom de la source de données: par exemple « Membres du programme de fidélité ».
- Champ d'identifiant unique: le champ JSON qui identifie chaque enregistrement, comme
customer_idouemail. Chaque enregistrement que tu envoies doit le contenir. - Description (facultatif).
- Clique sur Enregistrer la source de données. La source de données est créée et l' étape « API » affiche tes points de terminaison et ta clé API.
- Copie ce dont tu as besoin, puis clique sur Continuer pour terminer.

Tu peux retrouver ces points de terminaison à tout moment dans la section onglet « Détails de l'API » de la source de données.
Se connecter
Envoie ta clé dans l' Authorization en-tête de chaque requête :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonLa clé API de la source de données ne sert qu’à envoyer des enregistrements de source de données ; tu peux donc la communiquer en toute sécurité à un développeur ou à un outil d’automatisation. Si tu as souscrit à une formule API, ta clé API existante fonctionne également sur ces points de terminaison.
Ne mets pas ta clé dans le code frontal ni dans les dépôts publics. Si jamais elle venait à être exposée, régénère-la sous Paramètres → Clés API → Clé API de la source de données, puis mets à jour tout ce qui l'utilise.
Créer ou mettre à jour des fiches
ENVOIE un objet JSON unique ou un tableau d'objets vers le point de terminaison indiqué dans Sendtric. Un enregistrement :
POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"customer_id": "CUST_1001",
"first_name": "Sarah",
"points": 1250
}Plusieurs enregistrements dans une seule requête :
POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
[
{ "customer_id": "CUST_1001", "first_name": "Sarah", "points": 1250 },
{ "customer_id": "CUST_1002", "first_name": "James", "points": 300 }
]Comment les données sont enregistrées :
- Si aucun enregistrement ne porte encore cet identifiant, un nouvel enregistrement est créé.
- Si c'est le cas, c'est remplacé par ce que tu as envoyé. Les champs que tu ne remplis pas sont supprimés, alors envoie toujours l'enregistrement complet.
- Les nouvelles données et celles mises à jour sont généralement disponibles en une minute environ.
- La correspondance des identifiants ne tient pas compte de la distinction entre majuscules et minuscules.
Une requête réussie renvoie 200 un bref résumé, par exemple {"status":"ok","records":2}.
Tu peux imbriquer des objets dans un enregistrement, par exemple "address": { "city": "Leeds" }, et sélectionner des champs imbriqués dans l'éditeur d'images.
Supprimer des enregistrements
Pour supprimer un enregistrement, ajoute son identifiant à la fin de l'URL :
DELETE <your data source endpoint>/cust_1001
Authorization: Bearer YOUR_API_KEYPour en supprimer plusieurs, envoie un tableau d'identifiants :
DELETE <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
["cust_1001", "cust_1002"]Limites
| Limite | Valeur |
|---|---|
| Nombre d'enregistrements par requête | 10 000 |
| Taille de la requête | 10 Mo |
| Valeur de l'identifiant | 255 caractères |
| N'importe quelle valeur textuelle | 10 Ko |
| Profondeur d'imbrication | 20 niveaux |
Envoie les enregistrements par lots plutôt que d'envoyer une requête par enregistrement. Pour des milliers d'enregistrements, consulte comment envoyer de grandes quantités de données vers une source de données.
Réponses et erreurs
| Statut | Ce que ça veut dire | Que faire ? |
|---|---|---|
| 200 | Fiches acceptées | Rien. Si certains enregistrements ont été ignorés, l'en-tête « X-Skipped-Records » indique combien |
| 400 | Le corps du message n'est pas au format JSON valide | Vérifie le corps de la requête |
| 401 | Clé API manquante ou incorrecte | Vérifie l'en-tête « Authorization » |
| 404 | La source de données n'a pas été trouvée pour cette clé | Vérifie le point de terminaison et assure-toi que la clé appartient bien au même compte |
| 413 | Trop d'enregistrements ou trop volumineux | Divise la requête en petits lots |
| 422 | Aucun enregistrement n'a pu être enregistré | Le message indique quels enregistrements ne comportent pas le champ d'identifiant ou sont trop volumineux |
| 503 | Sendtric est occupé | Attends le nombre de secondes indiqué dans l'en-tête « Retry-After », puis renvoie la même requête |
Quand seuls certains enregistrements d'une requête ne sont pas valides, les enregistrements valides sont quand même enregistrés et les autres sont ignorés.
Vérifie tes dossiers
Ouvre la source de données et va dans la section onglet « Enregistrements » ». Effectue une recherche par valeur d'identifiant et clique sur un enregistrement pour voir l'intégralité du JSON Sendtric stocké.
Prochaine étape
- Comment utiliser une source de données dans une image personnalisée
- Comment utiliser une source de données dans une image basée sur des règles
- Comment gérer, modifier et supprimer une source de données
Cet article t'a-t-il été utile ?
Merci pour ton commentaire !
