Verarbeitungsstatus einer Anfrage nachschlagen

Verwenden Sie diesen Endpunkt, um zu prüfen, ob Braze die Verarbeitung einer Gruppe asynchroner Anfragen an den /users/track-Endpunkt abgeschlossen hat.

Wichtig

Dieser Endpunkt befindet sich in der Beta-Phase. Wenn Sie an der Beta teilnehmen möchten, wenden Sie sich an Ihren Braze Account Manager.

Eine erfolgreiche Antwort von /users/track bedeutet, dass Braze Ihre Anfrage empfangen und zur Verarbeitung in die Warteschlange eingereiht hat. Um zu bestätigen, dass die Verarbeitung abgeschlossen ist, fügen Sie in jede zugehörige /users/track-Anfrage dieselbe group_id ein und rufen Sie dann diesen Endpunkt mit dieser group_id auf. Wenn der status der Gruppe completed lautet, können Sie sicher Aktionen durchführen, die von diesen Daten abhängen, wie z. B. einen Canvas triggern oder eine Campaign starten.

Den vollständigen Workflow, Anforderungen an die Gruppen-ID, Limits und Aufbewahrung finden Sie unter Verarbeitungsstatus von Track-Anfragen.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung users.track.status. Die Berechtigung users.track umfasst keinen Zugang zu diesem Endpunkt.

Jeder API-Schlüssel im Workspace mit der Berechtigung users.track.status kann jede Gruppe in diesem Workspace nachschlagen, unabhängig davon, welcher API-Schlüssel die /users/track-Anfragen gesendet hat.

Rate-Limit

Braze wendet auf diesen Endpunkt ein Rate-Limit von 1.500 Anfragen pro Minute und Workspace an, wie in API-Rate-Limits dokumentiert. Dieses Limit ist vom Rate-Limit für /users/track getrennt.

Erfolgreiche Antworten enthalten die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, damit Sie verfolgen können, wie viel von Ihrem aktuellen Zeitfenster noch verbleibt.

Abfrageparameter

Beispielanfrage

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/users/track/status?group_id=loyalty_backfill_2026-09-23' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Antwort

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": (string) the group ID from your request,
      "status": (string) the processing status of the group, either "processing" or "completed",
      "received": (integer) the number of /users/track requests Braze accepted for this group,
      "done": (integer) the number of accepted requests Braze has finished processing,
      "processing": (integer) the number of accepted requests Braze is still processing,
      "final_completion_time": (string or null) when the last request in the group finished processing, in ISO 8601 format (UTC). This is null until the status is "completed".
    }
  ]
}

Das results-Array enthält ein Objekt, wenn Braze die Gruppe findet. Es ist leer, wenn die Gruppe im Workspace nicht existiert oder der 24-stündige Aufbewahrungszeitraum abgelaufen ist. Braze gibt in beiden Fällen ein leeres results-Array zurück, sodass ein leeres Array nicht darüber Auskunft gibt, ob eine Gruppe jemals existiert hat.

Antwortparameter

Der Status completed bedeutet, dass Braze die Verarbeitung jeder Anfrage in der Gruppe abgeschlossen hat, einschließlich Anfragen, bei denen Braze einige Objekte abgelehnt hat. Dieser Endpunkt gibt nur Anfragezahlen zurück und keine Ergebnisse für einzelne Attribute, Ereignisse oder Käufe. Um abgelehnte Objekte zu finden, überprüfen Sie das errors-Array in jeder /users/track-Antwort.

Beispielantworten

Gruppe wird noch verarbeitet

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": "loyalty_backfill_2026-09-23",
      "status": "processing",
      "received": 4,
      "done": 3,
      "processing": 1,
      "final_completion_time": null
    }
  ]
}

Gruppe abgeschlossen

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": "loyalty_backfill_2026-09-23",
      "status": "completed",
      "received": 4,
      "done": 4,
      "processing": 0,
      "final_completion_time": "2026-09-23T18:58:57.123Z"
    }
  ]
}

Gruppe nicht gefunden oder abgelaufen

1
2
3

{
  "results": []
}

Fehlerbehebung

Die folgende Tabelle listet Fehler auf, die dieser Endpunkt zurückgeben kann, und wie Sie diese beheben.

Für andere Statuscodes und Fehlermeldungen siehe Schwerwiegende Fehler und Antworten.