Intégrations de listes
/cdi/integrations
Utilisez cet endpoint pour obtenir une liste des intégrations existantes.
Pour utiliser cet endpoint, vous devrez générer une clé API avec l’autorisation cdi.integration_list
.
Limite de débit
This endpoint has a rate limit of 50 requests per minute.
Paramètres de recherche
Chaque appel à cet endpoint renverra 10 éléments. Pour une liste comportant plus de 10 intégrations, utilisez l’en-tête Link
pour récupérer les données à la page suivante, comme le montre l’exemple de réponse.
Paramètre | Requis | Type de données | Description |
---|---|---|---|
cursor |
Facultatif | Chaîne de caractères | Détermine la pagination de la liste d’intégration. |
Exemple de demande
Sans curseur
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Avec curseur
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Réponse
Exemple de réponse réussie
Le code de statut 200
pourrait renvoyer le corps de réponse suivant.
L’en-tête Link
n’existera pas s’il y a, au total, 10 intégrations ou moins. Pour les appels sans curseur, prev
ne s’affichera pas. Lors de la consultation de la dernière page de produits, next
ne s’affichera pas.
1
Link: </cdi/integrations?cursor=c2tpcDow>; rel="prev",</cdi/integrations?cursor=c2tpcDoxMDA=>; rel="next"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"results": [
{
"integration_id": (string) integration ID,
"app_group_id": (string) app group ID,
"integration_name": (string) integration name,
"integration_type": (string) integration type,
"integration_status": (string) integration status,
"contact_emails": (string) contact email(s),
"last_updated_at": (string) last timestamp that was synced in ISO 8601,
"warehouse_type": (string) data warehouse type,
"last_job_start_time": (string) timestamp of the last sync run in ISO 8601,
"last_job_status": (string) status of the last sync run,
"next_scheduled_run": (string) timestamp of the next scheduled sync in ISO 8601,
},
],
"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 cursor |
Vérifiez que votre cursor est valide. |
Pour connaître les autres codes d’état et les messages d’erreur associés, reportez-vous à la section Erreurs fatales et réponses.