국제메시지
국제메시지는 해외 수신자를 대상으로 메시지를 발송하는 채널 API입니다. 비즈고는 여러 해외 중계사와 연동해 국가별 발송 경로를 구성하며, 실제 단말 전달 여부와 무관하게 접수 기준으로 과금됩니다.
국제메시지 발송
POST/api/comm/v1/send/omni
국제메시지 발송 규격입니다. messageFlow[].international 객체를 사용하며 UTF-8 본문을 지원합니다. 국제메시지는 실제 단말 전달 여부와 무관하게 접수 기준으로 과금됩니다.
Body Parameters
{}JSONdestinations
필수 Object Array수신 정보 배열입니다. 동보발송 최대 200건입니다.
messageFlow
필수 Object Array메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.
paymentCode
String정산용 부서 코드입니다.
groupKey
String메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.
idempotencyKey
String요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.
idempotencyTtl
Integer멱등 처리키 유효시간 입니다.
ref
String요청 참조 필드입니다.
Returns
common
Object공통 응답 영역입니다.
data
Object서비스 응답 영역입니다.
요청 예시
1
curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \2
-H "Authorization: {ApiKey}" \3
-H "Content-Type: application/json" \4
-d '{5
"messageFlow": [{6
"international": {7
"from": "01000000000",8
"text": "Your verification code is 483920."9
}10
}],11
"destinations": [{12
"to": "821000000000"13
}],14
"ref": "international-20260331-001"15
}'응답 예시
1
{2
"common": {3
"authCode": "A000",4
"authResult": "Success",5
"infobankTrId": "Infobank-Tracking-Id"6
},7
"data": {8
"code": "A000",9
"result": "Success",10
"data": {11
"destinations": [{12
"to": "821000000000",13
"msgKey": "INT20260331-000001",14
"code": "A000",15
"result": "Success"16
}]17
},18
"ref": "international-20260331-001"19
}20
}