요청 처리 상태 조회

이 엔드포인트를 사용하여 Braze가 비동기 /users/track 엔드포인트 요청 그룹의 처리를 완료했는지 확인합니다.

중요

이 엔드포인트는 베타 버전입니다. 베타에 참여하고 싶으시다면 Braze 계정 매니저에게 문의하세요.

/users/track의 성공적인 응답은 Braze가 요청을 수신하여 처리 대기줄에 넣었다는 것을 의미합니다. 처리가 완료되었는지 확인하려면 관련된 각 /users/track 요청에 동일한 group_id를 포함한 다음, 해당 group_id로 이 엔드포인트를 호출하세요. 그룹의 status가 completed이면 Canvas 트리거나 Campaign 실행 등 해당 데이터에 의존하는 작업을 안전하게 수행할 수 있습니다.

전체 워크플로, 그룹 ID 요구 사항, 제한 및 유지에 대한 자세한 내용은 요청 처리 상태 추적을 참조하세요.

전제 조건

이 엔드포인트를 사용하려면 users.track.status 권한이 있는 API 키가 필요합니다. users.track 권한만으로는 이 엔드포인트에 접근할 수 없습니다.

워크스페이스에서 users.track.status 권한이 있는 모든 API 키는 /users/track 요청을 보낸 API 키와 관계없이 해당 워크스페이스의 모든 그룹을 조회할 수 있습니다.

사용량 제한

Braze는 API 사용량 제한에 명시된 대로 이 엔드포인트에 워크스페이스당 분당 1,500건의 요청에 대한 사용량 제한을 적용합니다. 이 제한은 /users/track 사용량 제한과 별도로 적용됩니다.

성공적인 응답에는 현재 윈도우의 남은 사용량을 추적할 수 있도록 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더가 포함됩니다.

쿼리 파라미터

요청 예시

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'

응답

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

results 배열은 Braze가 그룹을 찾으면 하나의 객체를 포함합니다. 그룹이 워크스페이스에 존재하지 않거나 24시간 유지 기간이 종료된 경우 비어 있습니다. Braze는 두 경우 모두 빈 results 배열을 반환하므로, 빈 배열만으로는 그룹이 존재했는지 여부를 알 수 없습니다.

응답 파라미터

completed 상태는 Braze가 일부 객체를 거부한 요청을 포함하여 그룹의 모든 요청을 처리 완료했음을 의미합니다. 이 엔드포인트는 요청 수만 보고하며 개별 속성, 이벤트 또는 구매에 대한 결과는 보고하지 않습니다. 거부된 객체를 확인하려면 각 /users/track 응답의 errors 배열을 확인하세요.

응답 예시

그룹 처리 중

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

그룹 완료

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

그룹을 찾을 수 없거나 만료됨

1
2
3

{
  "results": []
}

문제 해결

다음 표에는 이 엔드포인트에서 반환할 수 있는 오류와 해결 방법이 나와 있습니다.

기타 상태 코드 및 오류 메시지에 대해서는 심각한 오류 및 응답을 참조하세요.