월별 발송 성공 통계 데이터 조회 #

월별 발송 성공 통계 데이터를 조회합니다.

요청한 API Key의 채널 별 발송 성공 건수를 제공합니다. (성공 건수가 0일 경우 목록에서 제외)

Request #

URL

POST /msg/v1/stat
Authorization: Bearer {token}
Content-Type: application/json
Host: mnt-api.msghub.uplus.co.kr

HEADER

Name	Type	Required	Description
Authorization	String	true	사용자 인증 토큰

Request body

Name	Type	Required	Description
yearMonth	String	true	발송 성공 통계 년월 (yyyy-mm)
apiKey	String	true	API Key

CURL

curl -X POST "https://mnt-api.msghub.uplus.co.kr/msg/v1/stat" 
-H  "accept: */*" 
-H  "Content-Type: application/json" 
-H  "Authorization: Bearer {token}" 
-d "{\"yearMonth\":\"2025-01\",\"apiKey\":\"{apiKey}\"}"

Response #

Name	Type	Description
code	String	월별 발송 성공 통계 데이터 조회에 대한 결과 응답코드
message	String	월별 발송 성공 통계 데이터 조회에 대한 결과 응답코드 설명
data	List	결과 데이터

결과 데이터 상세

Name	Type	Description
projectName	String	프로젝트 명
apiKey	String	API KEY
apiKeyName	String	API KEY 명
statistics	List<MonthlyStat>	월별 통계 정보 목록

MonthlyStat 정보

Name	Type	Required	Description
ch	String	true	채널 명
productCode	String	true	상품 코드
succCnt	Integer	true	발송 성공 건수

Sample #

{
    "code": "10000",
    "message": "성공",
    "data": {
        "projectName": "프로젝트명",
        "apiKey": "{apiKey}",
        "apiKeyName": "{apiKeyName}",
        "statistics": [{
                "ch": "ALIMTALK",
                "productCode": "KALT1",
                "succCnt": 46
            }, {
                "ch": "FRIENDTALK",
                "productCode": "KFRT1",
                "succCnt": 16
            }, {
                "ch": "MMS",
                "productCode": "LMS",
                "succCnt": 12
            }, {
                "ch": "MMS",
                "productCode": "MMS",
                "succCnt": 5
            }, {
                "ch": "SMS",
                "productCode": "SMS",
                "succCnt": 97
            }
        ]
    }
}