Status der Auftragssynchronisation auflisten

Verwenden Sie diesen Endpunkt, um eine Liste der vergangenen Synchronisierungsstatus für eine bestimmte Integration zurückzugeben.

Hinweis

Um diesen Endpunkt zu verwenden, müssen Sie einen API-Schlüssel mit der Berechtigung cdi.integration_job_status erstellen.

Rate-Limit

Dieser Endpunkt hat ein Rate-Limit von 100 Anfragen pro Minute.

Pfadparameter

Abfrageparameter

Jeder Aufruf dieses Endpunkts gibt 10 Einträge zurück. Bei einer Integration mit mehr als 10 Synchronisierungen verwenden Sie den Link-Header, um die Daten auf der nächsten Seite abzurufen, wie in der folgenden Beispielantwort gezeigt.

Beispielanfrage

Ohne Cursor

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'

Mit Cursor

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'

Antwort

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 könnte den folgenden Antworttext zurückgeben.

Hinweis

Der Link-Header existiert nicht, wenn es insgesamt 10 oder weniger Synchronisierungen gibt. Bei Aufrufen ohne Cursor wird prev nicht angezeigt. Wenn Sie sich die letzte Seite der Einträge ansehen, wird next nicht angezeigt.

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"
}

Fehlerbehebung

In der folgenden Tabelle finden Sie eine Liste möglicher zurückgegebener Fehler und die entsprechenden Schritte zur Fehlerbehebung.

Weitere Statuscodes und zugehörige Fehlermeldungen finden Sie unter Schwerwiegende Fehler und Antworten.