Déclencher une synchronisation
/cdi/integrations/{integration_id}/sync
Utilisez cet endpoint pour déclencher immédiatement une synchronisation pour une intégration donnée, par exemple lorsque le chargement de votre entrepôt de données est terminé. Les synchronisations à la demande s’exécutent en complément de toute planification récurrente et ne la modifient pas. Si une synchronisation est déjà en cours pour l’intégration, la requête renvoie
429.
Pour utiliser cet endpoint, vous devez générer une clé API avec l’autorisation cdi.integration_sync.
Limite de débit
Cet endpoint a une limite de débit de 20 requêtes par minute.
Paramètres de chemin
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
integration_id |
Requis | Chaîne de caractères | ID d’intégration. Cette information est disponible dans l’URL lorsque vous consultez une intégration dans le tableau de bord de Braze. Le format de l’URL est https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. |
Exemple de requête
curl --location --request POST 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/sync' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Réponse
Exemple de réponse réussie
Le code de statut 202 pourrait renvoyer le corps de réponse suivant :
{
"message": "success"
}
Résolution des problèmes
Le tableau suivant répertorie les erreurs renvoyées possibles et les étapes de résolution des problèmes associées.
| Erreur | Résolution des problèmes |
|---|---|
400 Invalid integration ID |
Vérifiez que votre integration_id est valide. |
404 Integration not found |
Il n’existe pas d’intégration pour l’ID d’intégration donné. Assurez-vous que votre ID d’intégration est valide. |
429 Another job is in progress |
Une synchronisation est actuellement en cours pour cette intégration. Réessayez une fois la synchronisation terminée. |
Pour obtenir des codes de statut supplémentaires et les messages d’erreur associés, consultez la section Erreurs fatales et réponses.