메시지 통계
messages:list
Anchor link to전송된 메시지 목록을 표시합니다.
POST https://api.pushwoosh.com/api/v2/messages:list
| 이름 | 필수 | 설명 |
|---|---|---|
Authorization | 예 | 서버 API 토큰. 다음 형식으로 제공해야 합니다: Authorization: Api <Server Key>. |
요청 본문 매개변수
Anchor link to| 이름 | 필수 | 유형 | 설명 |
|---|---|---|---|
platforms | 아니요 | 배열 | 메시지 플랫폼. 가능한 값: "IOS", "ANDROID", "OSX", "WINDOWS", "AMAZON", "SAFARI", "CHROME", "FIREFOX", "IE", "EMAIL", "HUAWEI_ANDROID", "SMS". |
date_range | 아니요 | 객체 | 보고 기간, 메시지 생성 날짜로 필터링됩니다. date_from 및 date_to는 YYYY-MM-DD 형식을 따라야 합니다(예: "2000-01-01"). 두 날짜 모두 전체가 포함되므로 date_from과 date_to를 같은 날짜로 설정하면 해당 날짜 전체가 반환됩니다. 날짜는 계정 시간대가 아닌 UTC로 해석됩니다. |
campaign | 아니요 | 문자열 | 캠페인 코드 |
filters | 예 | 객체 | 메시지 필터. |
source | 아니요 | 문자열 | 메시지 소스. 예: AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS. |
messages_codes | 아니요 | 배열 | /createMessage API 응답에서 얻은 메시지 코드. |
messages_ids | 아니요 | 배열 | 메시지 기록에서 얻은 메시지 ID |
params | 아니요 | 객체 | 메시지 세부 정보와 메트릭을 표시할지 여부를 지정합니다. 응답에 "details" 객체를 포함하려면 with_details: true로 설정하고, "metrics" 객체를 포함하려면 with_metrics: true로 설정합니다. |
application | 예 | 문자열 | Pushwoosh 애플리케이션 코드. |
per_page | 아니요 | 정수 | 페이지당 결과 수, 1에서 499까지. 매개변수를 생략하면 기본 페이지 크기인 500개의 결과를 얻습니다. 500 이상을 명시적으로 전달하면 400으로 거부됩니다. |
page | 아니요 | 정수 | 페이지네이션을 위한 0부터 시작하는 페이지 번호. 아래의 딥 페이지네이션 제한을 참조하세요. |
요청 예시
Anchor link to{ "filters": { "platforms": [], // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS "date_range": { "date_from": "string", // 필수 형식: 2000-01-01 "date_to": "string" // 필수 형식: 2000-01-01 }, "source": "API", // AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS "campaign": "string", // 캠페인 코드 "messages_ids": [], // 메시지 ID "messages_codes": [], // 메시지 코드 "application": "string" // Pushwoosh 애플리케이션 코드 }, "params": { "with_details": true, // 응답에 메시지 세부 정보 추가 ("details" 객체) "with_metrics": true // 응답에 메시지 메트릭 추가 ("metrics" 객체) }, "per_page": 20, // <= 499 "page": 0}응답 코드 및 예시
{ "total": 0, "items": [{ "id": 0, "code": "string", "created_date": "string", "send_date": "string", "status": "string", "platforms": [], "source": "string", "push_info": { "details": { "title": "string", "filter_name": "string", "filter_code": "string", "content": { "key": "value" }, "platform_parameters": { "android_header": "string", "android_root_params": { "key": "value" }, "ios_title": "string", "ios_subtitle": "string", "ios_root_params": { "key": "value" }, "chrome_header": "string", "chrome_root_params": { "key": "value" }, "firefox_header": "string", "firefox_root_params": { "key": "value" }, "conditions": [ // 태그 조건 (/developer/api-reference/messages-api/#tag-conditions 참조) TAG_CONDITION1, TAG_CONDITION2, ..., TAG_CONDITIONN ], "conditions_operator": "AND", // 조건 배열에 대한 논리 연산자; 가능한 값: AND, OR "data": { "key": "value" } }, "follow_user_timezone": true }, "metrics": [{ "sends": 0, "opens": 0, "deliveries": 0, "inbox_opens": 0, "unshowable_sends": 0, "errors": 0, "platform": 0 }] }, "email_info": { "details": { "template": "string", "filter_name": "string", "filter_code": "string", "subject": { "key": "value" }, "from_name": "string", "from_email": "string", "reply_name": "string", "reply_email": "string", "follow_user_timezone": true, "conditions": [ // 태그 조건 (Messages-api - tag-conditions 참조) TAG_CONDITION1, TAG_CONDITION2, ..., TAG_CONDITIONN ], "conditions_operator": "AND" // 조건 배열에 대한 논리 연산자; 가능한 값: AND, OR }, "metrics": [{ "sends": 0, "opens": 0, "deliveries": 0, "hard_bounces": 0, "soft_bounces": 0, "rejects": 0, "confirmed_sends": 0, "unsubs": 0, "complaints": 0, "errors": 0 }] } }]}date_range가 30일을 초과합니다:
{ "error": "exceeded the maximum date interval. Max interval: 30 days"}page × per_page가 딥 페이지네이션 제한을 초과합니다:
{ "error": "requested result window is too large, narrow the date range"}{ "error": "account not found"}totalsByIntervals
Anchor link to메시지 코드를 기반으로 시간별로 집계된 메트릭 및 전환 데이터를 반환합니다.
POST https://api.pushwoosh.com/api/v2/statistics/messages/totalsByIntervals
인증은 요청 헤더의 API 액세스 토큰을 통해 처리됩니다.
요청 본문 매개변수
Anchor link to| 매개변수 이름 | 유형 | 설명 | 필수 |
|---|---|---|---|
message_code | string | /createMessage API 응답에서 얻은 메시지 코드. | 예 |
platforms | [int] | 플랫폼 | 아니요 |
요청 예시
Anchor link to{ "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // 필수. 고유 메시지 식별자 "platforms": [1, 3, 7, 10, 11, 12] // 선택 사항. 플랫폼 코드 목록}응답 필드
Anchor link to| 이름 | 유형 | 설명 |
|---|---|---|
metrics | 배열 | 메시지 메트릭 배열을 포함합니다 |
timestamp | string | 메트릭의 시간입니다. |
platform | int | 플랫폼 코드(예: iOS, Android). |
sends | string | 전송된 메시지 수. |
opens | string | 열람된 메시지 수. |
deliveries | string | 전송 완료된 메시지 수. |
inbox_opens | string | 받은 편지함 열람 수. |
unshowable_sends | string | OS 설정에서 알림이 꺼진 기기로 수락된 메시지 수입니다. 배너는 표시되지 않지만 메시지는 앱에 도달하며, 전송 시 받은 편지함에 메시지 저장이 활성화된 경우 메시지 받은 편지함에 나타납니다. 오류가 아닌 성공적인 전송으로 계산됩니다. |
errors | string | 오류 수. |
conversion | 객체 | 전환 데이터를 포함합니다 |
sends | string | 총 전송된 메시지 수. |
opens | string | 총 열람된 메시지 수. |
events | 배열 | 통계가 포함된 이벤트 배열 |
name | string | 이벤트 이름(예: cart add). |
hits | string | 조회수. |
conversion | float | 열람 대비 전환율. |
revenue | float | 수익(__amount 및 __currency 속성이 있는 이벤트에만 해당). |
응답 예시
Anchor link to{ "metrics": [{ "timestamp": "2024-08-03 15:00:00", // "YYYY-MM-DD HH:MM:SS" 형식의 메트릭 타임스탬프 "platform": 3, // 플랫폼 코드 "sends": "55902", // 전송된 메시지 수 "opens": "382", // 열람된 메시지 수 "deliveries": "22931", // 전송 완료된 메시지 수 "inbox_opens": "0", // 받은 편지함에서 열람된 메시지 수 "unshowable_sends": "2", // 알림이 꺼진 기기로 전송됨, 배너 표시 안 됨 "errors": "0" // 발생한 오류 수 }], "conversion": { "sends": "55902", // 총 전송된 메시지 수 "opens": "772", // 총 열람된 메시지 수 "events": [{ "name": "cart_add", // 이벤트 이름 "hits": "96", // 이벤트 조회수 "conversion": 0.12, // 열람 대비 전환율 "revenue": 0 // 이벤트로 발생한 수익(금액/통화 속성이 있는 이벤트에만 해당) }] }}getMessageLog
Anchor link to전송된 메시지에 대한 자세한 정보를 표시합니다.
POST https://api.pushwoosh.com/api/v2/statistics/getMessageLog
| 이름 | 필수 | 설명 |
|---|---|---|
Authorization | 필수 | Pushwoosh 제어판의 API 액세스 토큰. |
요청 본문 매개변수
Anchor link to| 이름 | 필수 | 유형 | 설명 |
|---|---|---|---|
message_id | 아니요 | 정수 | 메시지 기록에서 얻은 메시지 ID로 메시지 이벤트를 선택합니다. 예: 12345678900. |
message_code | 아니요 | 문자열 | /createMessage API 응답에서 얻은 메시지 코드로 메시지 이벤트를 선택합니다. 예: "A444-AAABBBCC-00112233". |
campaign_code | 아니요 | 문자열 | 메시지 페이로드에 지정된 캠페인 코드로 메시지 이벤트를 선택합니다. 예: "AAAAA-XXXXX". |
hwid | 아니요 | 문자열 또는 배열 | HWID (하드웨어 ID) 또는 HWID 배열로 메시지 이벤트를 선택합니다. |
date_from | message_id, message_code 또는 campaign_code가 제공되지 않은 경우 필수 | 날짜/시간 | 메시지 필터링 시작 날짜. 형식: "YYYY-MM-DD HH:MM:SS". 예: "2000-01-25 00:00:00". |
date_to | message_id, message_code 또는 campaign_code가 제공되지 않은 경우 필수 | 날짜/시간 | 메시지 필터링 종료 날짜. 형식: "YYYY-MM-DD HH:MM:SS". 예: "2000-01-26 00:00:00". |
limit | 아니요 | 정수 | 단일 응답으로 반환되는 최대 메시지 이벤트 수. 최대값: 100000. |
pagination_token | 아니요 | 문자열 | 이전 /getMessageLog 응답에서 얻은 페이지네이션 토큰. 추가 결과를 검색하는 데 사용합니다. |
user_id | 아니요 | 문자열 | 사용자 지정 사용자 ID로 메시지 이벤트를 선택합니다. 자세한 내용은 /registerUser를 참조하세요. |
application_code | 예 | 문자열 | Pushwoosh 애플리케이션 코드로 메시지 이벤트를 선택합니다. |
actions | 아니요 | 배열 | 특정 메시지 작업으로 결과를 필터링합니다. 가능한 값: "sent", "delivered", "opened", "reject", "create", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". "create" 이벤트는 기본적으로 응답에서 제외됩니다. 이를 보려면 이 배열에 "create"를 포함하세요. "delivered" 이벤트는 추가로 계정에서 전송 통계를 활성화해야 합니다. |
platforms | 아니요 | 배열 | 결과를 필터링할 대상 플랫폼 배열. 가능한 값: "unknown", "ios", "blackberry", "android", "windows phone", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "fb messenger", "baidu android", "huawei android", "sms", "xiaomi", "web", "whatsapp", "line", "kakao", "telegram", "apple wallet", "google wallet", "viber". |
message_type | 아니요 | 문자열 | 메시지 흐름으로 결과를 필터링합니다. "all"(생략 시 기본값)은 모든 것을 반환하고, "broadcast"는 대량 메시지(message_id != 0)만 반환하며, "transactional"은 Customer Journey에서 보낸 메시지를 포함하여 message_id = 0인 메시지만 반환합니다. |
요청 예시
Anchor link tocurl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/getMessageLog' \--header 'Authorization: Key API_ACCESS_TOKEN' \--header 'Content-Type: application/json' \--data-raw '{ "pagination_token": "PAGINATION_TOKEN_FROM_PREVIOUS_RESPONSE", // 선택 사항, 페이지네이션용 토큰 "limit": 1000, // 선택 사항, 단일 응답의 최대 항목 수 "application_code": "XXXXX-XXXXX", // Pushwoosh 앱 코드 "message_code": "A444-AAABBBCC-00112233", // 선택 사항, /createMessage 요청에서 얻은 메시지 코드 "message_id": 1234567890, // 선택 사항, Pushwoosh 제어판에서 얻은 메시지 ID "campaign_code": "AAAAA-XXXXX", // 선택 사항, 로그를 가져올 캠페인 코드 "hwid": "aaazzzqqqqxxx", // 선택 사항, 메시지 대상 특정 기기의 하드웨어 ID "user_id": "user_123", // 선택 사항, 메시지 대상 사용자의 ID "date_from": "2000-01-25 00:00:00", // 선택 사항, 통계 기간 시작 "date_to": "2000-02-10 23:59:59", // 선택 사항, 통계 기간 종료 "actions": ["opened", "inbox_opened"], // 선택 사항, 결과 필터링에 사용됩니다. 가능한 값: "sent", "delivered", "opened", "reject", "create", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". 응답에는 지정된 작업이 있는 모든 메시지가 포함됩니다. "platforms": ["ios", "chrome"], // 선택 사항, 결과 필터링에 사용되며 소문자만 가능합니다. 가능한 값: "unknown", "ios", "blackberry", "android", "windows phone", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "fb messenger", "baidu android", "huawei android", "sms", "xiaomi", "web", "whatsapp", "line", "kakao", "telegram", "apple wallet", "google wallet", "viber" "message_type": "broadcast" // 선택 사항, "all"(기본값), "broadcast"(message_id != 0) 또는 "transactional"(message_id = 0, Customer Journey 전송 포함)}'응답 코드 및 예시
{ "pagination_token": "PAGINATION_TOKEN_FOR_NEXT_REQUEST", "data": [{ "timestamp": "2000-01-25T11:18:47Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "sent", "status": "success", "push_alerts_enabled": "true" }, { "timestamp": "2000-01-25T11:18:49Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "delivered", "push_alerts_enabled": "true" }, { "timestamp": "2000-01-25T11:19:23Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "opened", "push_alerts_enabled": "true" }, { "timestamp": "2000-01-25T11:19:30Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "reject", "status": "failed", "error_reason": "invalid device token", "payload": "SOME_PAYLOAD_STRING" }]}{ "error": "exceeded the maximum date interval. Max interval: 30 days"}{ "error": "account not found"}data의 각 항목에는 error_reason(문자열, status가 "failed"일 때 실패 이유로 채워짐)과 선택적 payload(문자열)도 포함됩니다.
응답 페이지는 요청된 limit보다 짧게 반환될 수 있습니다. 그것만으로는 내보내기가 완료되었다는 의미가 아닙니다.
이메일 통계
Anchor link tolinksInteractions
Anchor link to이메일의 링크 클릭에 대한 통계를 표시합니다
POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions
| 이름 | 필수 | 설명 |
|---|---|---|
Authorization | 예 | Pushwoosh 제어판의 API 액세스 토큰. |
요청 본문 매개변수
Anchor link to| 이름 | 필수 | 유형 | 설명 |
|---|---|---|---|
date_range | 아니요 | 객체 | 보고 기간을 정의합니다. date_from과 date_to를 포함합니다. |
filters | 예 | 객체 | 이메일 필터. |
application | 예 | 문자열 | Pushwoosh 애플리케이션 코드 (또는 campaign, messages_ids, message_codes를 지정). |
messages_codes | 예 | 배열 | 메시지 코드 (또는 application, campaign, messages_ids를 지정). |
campaign | 예 | 문자열 | 캠페인 코드 (또는 application, messages_ids, message_codes를 지정). |
messages_ids | 예 | 배열 | 메시지 ID (또는 application, campaign, message_codes를 지정). |
link_template | application 또는 campaign이 지정된 경우 필수. | 문자열 | 키워드로 이메일 링크 상호 작용을 필터링합니다. URL에 지정된 텍스트를 포함하는 링크만 API 응답으로 반환됩니다. 예를 들어, 이메일에 https://example.com/news와 https://example.com/shop 같은 링크가 포함된 경우, "link_template": "shop"으로 설정하면 https://example.com/shop에 대한 상호 작용만 반환됩니다. |
email_content_code | 아니요 | 문자열 | 이메일 콘텐츠의 고유 식별자. |
params | 아니요 | 객체 | 추가 응답 옵션을 정의합니다. 통계가 포함된 전체 링크 목록을 추가하는 with_full_links를 포함합니다. |
요청 예시
Anchor link tocurl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions' \--header 'Authorization: Api API_ACCESS_TOKEN' \--header 'Content-Type: application/json' \--data-raw '{ "filters": { "date_range": { "date_from": "string", // 필수 형식: 2000-01-01 "date_to": "string" // 필수 형식: 2000-01-01 }, "campaign": "string", // 캠페인 코드 (대신 application, messages_ids 또는 message_codes를 지정할 수 있습니다) "application": "string", // 애플리케이션 코드 (대신 campaign, messages_ids 또는 message_codes를 지정할 수 있습니다) "messages_ids": [], // 메시지 ID (대신 application, campaign 또는 message_codes를 지정할 수 있습니다) "messages_codes": [], // 메시지 코드 (대신 application, campaign 또는 message_ids를 지정할 수 있습니다) "link_template": "string", // 링크 템플릿 (application 또는 campaign이 지정된 경우 필수) "email_content_code": "string" // 이메일 콘텐츠의 고유 식별자. }, "params": { "with_full_links": true // 자세한 통계를 표시할지 여부를 지정합니다. 통계가 포함된 전체 링크 목록이 full_links 배열로 전달됩니다. }}'응답 코드 및 예시
Anchor link to{ "items": [{ "template": "string", "link": "string", "title": "string", "clicks": 0, "full_links": [{ "full_link": "string", "clicks": 0 }] }]}{ "error": "exceeded the maximum date interval. Max interval: 30 days"}{ "error": "account not found"}linksInteractionsDevices
Anchor link to이메일의 링크를 클릭한 사용자를 표시합니다
POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices
| 이름 | 필수 | 설명 |
|---|---|---|
Authorization | 예 | Pushwoosh 제어판의 API 액세스 토큰. |
요청 본문 매개변수
Anchor link to| 이름 | 필수 | 유형 | 설명 |
|---|---|---|---|
date_range | 아니요 | 객체 | 보고 기간을 정의합니다. date_from과 date_to를 포함합니다. |
filters | 예 | 객체 | 이메일 필터. |
application | 예 | 문자열 | Pushwoosh 애플리케이션 코드 (또는 campaign, messages_ids, message_codes를 지정). |
messages_codes | 예 | 배열 | 메시지 코드 (또는 application, campaign, messages_ids를 지정). |
campaign | 예 | 문자열 | 캠페인 코드 (또는 application, messages_ids, message_codes를 지정). |
messages_ids | 예 | 배열 | 메시지 ID (또는 application, campaign, message_codes를 지정). |
link_template | application 또는 campaign이 지정된 경우 필수. | 문자열 | 키워드로 이메일 링크 상호 작용을 필터링합니다. URL에 지정된 텍스트를 포함하는 링크만 API 응답으로 반환됩니다. 예를 들어, 이메일에 https://example.com/news와 https://example.com/shop 같은 링크가 포함된 경우, "link_template": "shop"으로 설정하면 https://example.com/shop에 대한 상호 작용만 반환됩니다. |
email_content_code | 아니요 | 문자열 | 이메일 콘텐츠의 고유 식별자. |
page | 아니요 | 정수 | 페이지네이션을 위한 페이지 번호. |
per_page | 아니요 | 정수 | 페이지당 결과 수 (≤ 1000). |
요청 예시
Anchor link tocurl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices' \--header 'Authorization: Api API_ACCESS_TOKEN' \--header 'Content-Type: application/json' \--data-raw '{ "filters": { "date_range": { "date_from": "string", // 필수 형식: 2000-01-01 "date_to": "string" // 필수 형식: 2000-01-01 }, "campaign": "string", // 캠페인 코드 (대신 application, messages_ids 또는 message_codes를 지정할 수 있습니다) "application": "string", // 애플리케이션 코드 (대신 campaign, messages_ids 또는 message_codes를 지정할 수 있습니다) "messages_ids": [], // 메시지 ID (대신 application, campaign 또는 message_codes를 지정할 수 있습니다) "messages_codes": [], // 메시지 코드 (대신 application, campaign 또는 message_ids를 지정할 수 있습니다) "link_template": "string", // 링크 템플릿 (application 또는 campaign이 지정된 경우 필수) "email_content_code": "string" // 이메일 콘텐츠의 고유 식별자. }, "per_page": 100, "page": 0}'응답 코드 및 예시
Anchor link to{ "total": 0, "items": [{ "timestamp": "string", "link": "string", "hwid": "string" }]}{ "error": "exceeded the maximum date interval. Max interval: 30 days"}{ "error": "account not found"}bouncedEmails
Anchor link toPOST https://api.pushwoosh.com/api/v2/statistics/emails/bouncedEmails
각 반송에 대한 날짜, 이메일 주소, 이유를 포함하여 이메일 불만, 소프트 바운스, 하드 바운스에 대한 데이터를 제공합니다.
인증은 요청 헤더의 API 액세스 토큰을 통해 처리됩니다.
요청 본문 매개변수
Anchor link to| 매개변수 이름 | 유형 | 설명 | 필수 |
|---|---|---|---|
application | string | Pushwoosh 애플리케이션 코드 | 예 |
message_code | string | 메시지 코드. | date range 또는 campaign이 제공되지 않은 경우 필수 |
campaign | string | 캠페인 코드. | message_code 또는 date range이 제공되지 않은 경우 필수 |
date_from | string | YYYY-MM-DDTHH:MM:SS.000Z 형식(ISO 8601 표준)의 데이터 시작 날짜. | message_code 또는 campaign이 제공되지 않은 경우 필수 |
date_to | string | YYYY-MM-DDTHH:MM:SS.000Z 형식(ISO 8601 표준)의 데이터 종료 날짜. | message_code 또는 campaign이 제공되지 않은 경우 필수 |
per_page | int | 페이지당 행 수, 최대 5000. | 예 |
page | int | 페이지 번호, 0부터 시작. | 예 |
type | string | 반송 유형: Complaint, Softbounce, Hardbounce. | 아니요 |
요청 예시
Anchor link to{ "application": "XXXXX-XXXXX", // 필수. Pushwoosh 앱 코드 "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // campaign 또는 date range가 제공되지 않은 경우 필수. // 고유 메시지 식별자 "campaign": "XXXXX-XXXXX", // message_code 또는 date range가 제공되지 않은 경우 필수. // 캠페인 코드 "date_from": "2024-07-20T00:00:00.000Z", // message_code 또는 campaign이 제공되지 않은 경우 필수. // ISO 8601 형식 "YYYY-MM-DDTHH:MM:SS.SSSZ"의 시작 날짜 "date_to": "2024-07-20T00:00:00.000Z", // message_code 또는 campaign이 제공되지 않은 경우 필수. // ISO 8601 형식 "YYYY-MM-DDTHH:MM:SS.SSSZ"의 종료 날짜 "per_page": 1000, // 필수. 페이지당 결과 수, 최대 5000 "page": 5, // 선택 사항. 페이지 번호, 0부터 시작 "type": "Softbounce" // 선택 사항. 반송 유형: Complaint, Softbounce, Hardbounce}응답 필드
Anchor link to| 필드 이름 | 유형 | 설명 |
|---|---|---|
total | int | 총 행 수. |
bounced_emails | array | 반송된 이메일 세부 정보 배열. |
├── email | string | 반송된 이메일 주소. |
├── date | string | 반송 날짜 (형식: YYYY-MM-DDTHH:MM:SS.000Z). |
├── reason | string | 반송 이유. |
└── type | string | 반송 유형: Complaint, Softbounce, Hardbounce. |
응답 예시
Anchor link to{ "total": 25, // 총 행 수. "bounced_emails": [{ "email": "example@example.com", // 반송된 이메일 주소 "date": "2024-07-20T00:00:00.000Z", // ISO 8601 형식의 반송 날짜 "reason": "Invalid recipient address", // 반송 이유 "type": "Hardbounce" // 반송 유형: Complaint, Softbounce, Hardbounce }]}