MO(인증/투표)
MO는 사용자가 특정 번호로 회신하거나 참여한 인증, 투표 성격의 수신 메시지를 의미합니다.
기본 연동은 수신받기(Webhook)로 처리하고, 누락 확인이나 보완 조회가 필요한 경우 개별조회(Inquiry)를 사용합니다.
수신받기(Webhook)
POST{등록한 Webhook URL}
사전에 등록한 Webhook URL로 MO 메시지를 전달받습니다. 실제 Webhook URI는 수신 시스템마다 다를 수 있으며, 본 문서는 POST body 규격을 설명합니다.
Body Parameters
{}JSONmsgKey
필수String메시지 키입니다.
serviceType
필수String서비스 타입입니다.
msgType
필수String메시지 타입입니다.
to
필수String수신번호(MO 번호)입니다.
from
필수StringMO발신자가 수동으로 입력한번호(기본적으로 단말기번호).
carrier
필수String이통사코드.
originator
필수StringMO 발신 단말기 번호.
content
필수StringMO 메시지 본문 내용입니다.
occurredTime
필수StringMO 발생 시각입니다.
Returns
msgKey
String수신한 메시지 키를 그대로 반환합니다.
요청 예시
1
curl -X POST "https://client.example.com/webhooks/mo" \2
-H "Content-Type: application/json" \3
-d '{4
"msgKey":"20260423141101437PSM949194539147",5
"serviceType":"MO",6
"msgType":"SM",7
"to":"#000000",8
"from":"0100000000",9
"carrier":"10001",10
"originator":"0100000000",11
"content":"그랜드 오픈!!!",12
"occurredTime":"2026-04-23T14:11:01+09:00"13
}'응답 예시
1
{2
"msgKey":"20260423141101437PSM949194539147"3
}개별조회(Inquiry)
GET/api/comm/v1/mo/inquiry/{msgKey}
특정 msgKey의 MO 수신 내역을 조회합니다. Webhook 누락이나 수신 시스템 점검 시 보완 조회 용도로 사용할 수 있습니다.
Path Parameters
PATHmsgKey
필수String조회할 메시지 키입니다.
Returns
common
Object공통 응답 영역입니다.
data
Object서비스 응답 영역입니다.
요청 예시
1
curl -X GET "https://mars.ibapi.kr/api/comm/v1/mo/inquiry/20260423141101437PSM949194539147" \2
-H "Authorization: {ApiKey}" \3
-H "Accept: application/json"응답 예시
1
{2
"common": {3
"authCode":"A000",4
"authResult":"Success",5
"infobankTrId":"header-value-X-Infobank-Tracking-Id"6
},7
"data": {8
"code":"A000",9
"result":"Success",10
"data": {11
"mo": {12
"msgKey":"20260423141101437PSM949194539147",13
"serviceType":"MO",14
"msgType":"SM",15
"to":"#000000",16
"from":"0100000000",17
"carrier":"10001",18
"originator":"0100000000",19
"content":"그랜드 오픈!!!",20
"occurredTime":"2026-04-23T14:11:01+09:00"21
}22
}23
}24
}