Zum Inhalt springen

Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Eine Synchronisation auslösen

post

/cdi/integrations/{integration_id}/sync

Verwenden Sie diesen Endpunkt, um eine Synchronisation für eine bestimmte Integration sofort zu starten, beispielsweise wenn das Laden Ihres Warehouse abgeschlossen ist. On-Demand-Synchronisierungen werden zusätzlich zu jedem wiederkehrenden Zeitplan ausgeführt und ändern diesen nicht. Wenn bereits eine Synchronisation für die Integration läuft, gibt die Anfrage 429 zurück.

Hinweis

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

Rate-Limit

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

Pfad-Parameter

Parameter	Erforderlich	Datentyp	Beschreibung
`integration_id`	Erforderlich	String	Integrations-ID. Diese finden Sie in der URL, wenn Sie eine Integration im Braze-Dashboard anzeigen. Das URL-Format lautet `https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]`.

Beispielanfrage

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'

Antwort

Beispiel für eine erfolgreiche Antwort

Der Statuscode 202 könnte den folgenden Antwortkörper zurückgeben:

{
  "message": "success"
}

Fehlerbehebung

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

Fehler	Fehlerbehebung
`400 Invalid integration ID`	Prüfen Sie, ob Ihre `integration_id` gültig ist.
`404 Integration not found`	Für die angegebene Integrations-ID existiert keine Integration. Vergewissern Sie sich, dass Ihre Integrations-ID gültig ist.
`429 Another job is in progress`	Für diese Integration wird derzeit eine Synchronisation durchgeführt. Versuchen Sie es erneut, nachdem die Synchronisation abgeschlossen ist.

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

New Stuff!