SEsendon
Statistics

메시지 발송 상세 정보 조회

특정 메시지 그룹에 속한 모든 개별 메시지의 발송 상세 정보를 조회합니다. 수신자별 발송 결과, 전송 상태, 오류 사유, 발송 일시 등의 세부 정보를 확인할 수 있어 발송 결과 분석에 활용할 수 있습니다.

get/v2/statistics/messaging/groups/{groupId}/messages

Request

  • Base URL
    https://api.sendon.io
  • URL
    https://api.sendon.io/v2/statistics/messaging/groups/{groupId}/messages
  • Auth
    HTTP basic

Path parameters

groupIdstring required

메시지 그룹의 ID입니다.

Query parameters

messageStatusstring

필터링할 메시지 상태입니다. 여러 상태를 조회하려면 콤마(,)로 구분하여 입력하세요.

searchBystring

수신자 전화번호 또는 메시지 본문, 제목에서 검색하려는 문자열입니다.

limitnumber

한 번에 응답받을 데이터의 개수입니다. 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.

cursorstring

페이징을 위한 커서 오프셋 값입니다. 다음 페이지를 요청할 때 이전 응답에서 받은 값을 사용하세요.

Response

메시지 그룹의 상세 발송 정보 조회가 성공적으로 완료되었습니다. 각 개별 메시지의 발송 결과와 수신자 정보가 반환됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.

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

Changes

No recorded changes to this operation across all 2 revisions of this API.