4. 발송 결과 통계

개요

브랜드 메시지 발송 통계를 조회합니다.

API Server URL: https://bizmsgapi.fingerpush.com/rest/kkb/v1/getBrandMsgSendlist

---

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

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	설명
senderKey	필수	text(40)	카카오 발신프로필 키
msgIdx	필수	text(18)	캠페인 메시지 IDX

Request JSON Sample

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "msgIdx": "12345678910"
}

Response JSON

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

{
  "code": "200",
  "message": "",
  "data": {
    "sent": 95,
    "failed": 5,
    "rpcSms": 2,
    "rpcLms": 0,
    "rpcFailure": 1,
    "updateDate": "2026-01-28 15:07:25"
  }
}

[표 3.2] 발송 JSON 결과

값	설명
code	결과 코드
message	결과 메시지
data.sent	발송 성공 수
data.failed	발송 실패 수
data.rpcSms	SMS 전환 발송 수
data.rpcLms	LMS 전환 발송 수
data.rpcFailure	전환 발송 실패 수
data.updateDate	갱신일

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

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

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