Skip to content

반송된 이메일 조회

get

/email/hard_bounces

이 엔드포인트를 사용하여 특정 기간 내에 이메일 메시지를 ‘하드 바운스’된 이메일 주소 목록을 가져올 수 있습니다.

필수 구성 요소

이 엔드포인트를 사용하려면 email.hard_bounces 권한이 있는 API 키가 필요합니다.

사용량 제한

API 속도 제한에 설명된 대로 이 엔드포인트에 시간당 250,000건의 기본 Braze 속도 제한을 적용합니다.

요청 매개변수

매개변수 필수 데이터 유형 설명
start_date 선택 사항
(참고 참조)
YYYY-MM-DD 형식의 문자열 검색할 하드 바운스의 시작 날짜는 end_date보다 이전이어야 합니다. API에 의해 이것은 UTC 시간으로 자정으로 처리됩니다.
end_date 선택 사항
(참고 참조)
YYYY-MM-DD 형식의 문자열 범위를 검색할 종료 날짜를 하드 바운스합니다. API에 의해 이것은 UTC 시간으로 자정으로 처리됩니다.
limit 선택 사항 정수 반환되는 결과 수를 제한하는 선택적 필드입니다. 기본값은 100, 최대값은 500입니다.
offset 선택 사항 정수 검색할 목록의 시작점(선택 사항)입니다.
email 선택 사항
(참고 참조)
문자열 제공된 경우, 사용자가 하드 바운스했는지 여부를 반환합니다. 이메일 문자열이 올바르게 형식화되었는지 확인하십시오.

날짜 범위에 하드 바운스 횟수가 limit 보다 많은 경우, 호출이 limit 보다 적거나 결과가 0이 될 때까지 매번 offset 을 증가시키면서 여러 번 API 호출을 수행해야 합니다. offsetlimit 매개 변수를 email 과 함께 포함하면 빈 응답을 반환할 수 있습니다.

요청 예시

응답

항목은 내림차순으로 나열됩니다.

이 페이지가 얼마나 도움이 되었나요?
New Stuff!