Liste de l’état de synchronisation des travaux

Utilisez cet endpoint pour renvoyer une liste des états de synchronisation passés pour une intégration donnée.

Remarque

Pour utiliser cet endpoint, vous devrez générer une clé API avec l’autorisation cdi.integration_job_status.

Limite de débit

Cet endpoint a une limite de débit de 100 requêtes par minute.

Paramètres de chemin

Paramètres de requête

Chaque appel à cet endpoint renverra 10 éléments. Pour une intégration avec plus de 10 synchronisations, utilisez l’en-tête Link pour récupérer les données sur la page suivante, comme le montre l’exemple de réponse suivant.

Exemple de requête

Sans curseur

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status' \
--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/00000000-0000-0000-0000-000000000000/job_sync_status?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.

Remarque

L’en-tête Link n’existe pas si le nombre total de synchronisations est inférieur ou égal à 10. Pour les appels sans curseur, prev ne s’affichera pas. Lors de la consultation de la dernière page d’éléments, next ne s’affichera pas.

1
Link: </cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow>; rel="prev",</cdi/integrations00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDoxMDA=>; rel="next"

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "results": [
    {
        "job_status": (string) status of the sync, see below for explanation of different statuses,
        "sync_start_time": (string) time the sync started in ISO 8601,
        "sync_finish_time": (string) time the sync finished in ISO 8601,
        "last_timestamp_synced": (string) last UPDATED_AT timestamp processed by the sync in ISO 8601,
        "rows_synced": (integer) number of rows successfully synced to Braze,
        "rows_failed_with_errors": (integer) number of rows failed because of errors
    }
  ],
  "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.

Pour obtenir des codes de statut supplémentaires et les messages d’erreur associés, veuillez vous référer à la section Erreurs fatales et réponses.