Statistics
메시지 발송 상세 정보 조회
특정 메시지 그룹에 속한 모든 개별 메시지의 발송 상세 정보를 조회합니다. 수신자별 발송 결과, 전송 상태, 오류 사유, 발송 일시 등의 세부 정보를 확인할 수 있어 발송 결과 분석에 활용할 수 있습니다.
get/v2/statistics/messaging/groups/{groupId}/messages
Path parameters
groupIdstring required
메시지 그룹의 ID입니다.
Query parameters
messageStatusstring
필터링할 메시지 상태입니다. 여러 상태를 조회하려면 콤마(,)로 구분하여 입력하세요.
searchBystring
수신자 전화번호 또는 메시지 본문, 제목에서 검색하려는 문자열입니다.
limitnumber
한 번에 응답받을 데이터의 개수입니다. 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.
cursorstring
페이징을 위한 커서 오프셋 값입니다. 다음 페이지를 요청할 때 이전 응답에서 받은 값을 사용하세요.
Response
메시지 그룹의 상세 발송 정보 조회가 성공적으로 완료되었습니다. 각 개별 메시지의 발송 결과와 수신자 정보가 반환됩니다.
Example response
{
"code": 200,
"message": "OK",
"data": {
"results": [
{
"from": "01012345678",
"to": "01087654321",
"messageId": "004a6217-f06c-40f6-8f39-bf35b3f76111",
"messageSubject": "중요한 안내 메시지",
"messageBody": "안녕하세요. 문자 메시지 발송 테스트입니다.",
"messageStatus": "SUCCESS",
"resultCode": "0",
"resultText": "성공",
"requestTime": "2024-12-25T10:00:00Z",
"sendTime": "2024-12-25T10:00:05Z",
"telecom": "SKT",
"groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
}
]
}
}