4. 발송 결과 통계

개요

문자메시지 발송 통계를 조회합니다.

API Server URL: https://bizmsgapi.fingerpush.com/rest/mms/v1/getMmsSendlist

---

발송 방법 및 전송/수신 파라미터 정의

HTTPS Headers

파라미터명	필수 여부	설명
Content-Type	필수	application/json
authorization	필수	Bearer {token} 토큰 발급 API에서 발급받은 JWT 토큰 값

HTTPS Parameters

SSL Protocol을 이용하여 파라미터들을 API Server에 전달합니다. API Server로 전달해야 할 파라미터들은 아래 표를 참조해 주세요.

[표 3.1] 문자 발송 통계 HTTPS, Parameters

파라미터명	필수 여부	Data Type	설명
msgIdx	필수	text(18)	캠페인 메시지 IDX

Request JSON Sample

{
  "msgIdx": "12345678910"
}

Response JSON

API서버에서 전달 받은 파라미터 처리 후 결과를 JSON 형태로 제공합니다.

{
  "code": "200",
  "message": "",
  "data": {
    "sent": 80,
    "failed": 5,
    "smsCnt": 60,
    "lmsCnt": 15,
    "mmsCnt": 5,
    "bannedCnt": 2,
    "updateDate": "2026-02-20 11:13:50"
  }
}

[표 3.2] 발송 JSON 결과

값	설명
code	결과 코드
message	결과 메시지
data.sent	전체발송 성공 수
data.failed	발송실패 수
data.smsCnt	SMS 발송 성공 수
data.lmsCnt	LMS 발송 성공 수
data.mmsCnt	MMS 발송 성공 수
data.bannedCnt	수신 거부 수
data.updateDate	갱신일

처리결과에 따른 result 값은 아래와 같습니다.

[표 3.3] 발송 JSON 결과의 result code 유형

코드	내용	비고
200	정상처리 됨	취소 완료
401	접근 권한이 없습니다.	계정 서비스 권한 여부
403	필수 값이 없습니다.
4033	메시지에 대한 접근 권한이 없습니다.	메시지 정보 없음
4035	유효한 호출이 아닙니다.	인증 토큰 누락
4036	유효한 호출이 아닙니다.	인증 토큰 만료
4037	유효한 호출이 아닙니다.	화이트리스트에 존재하지 않는 IP