문자메시지

국내 문자 발송은 단문(SMS), 장문(LMS), 이미지 포함 장문(MMS)으로 구성됩니다.
메시지 타입별로 본문 필드가 다르며, 아래에서 각각의 필드/요청/응답 예시를 확인할 수 있습니다.

SMS(단문메시지) 발송

POST/api/comm/v1/send/omni

메시지 발송 체험하기 샌드박스로 테스트하기

인증번호, 안내성 단문 발송에 사용합니다. messageFlow[].sms 객체를 사용하며 본문은 최대 90byte이고 제목(title) 필드는 없습니다.

Body Parameters

{}JSON

destinations

필수 Object Array

수신 정보 배열입니다. 동보발송 최대 200건입니다.

필수 String

수신번호입니다.

ref

String

개별 참조 필드입니다.

messageFlow

필수 Object Array

메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.

sms

필수 Object

SMS 메시지 정보입니다.

from

필수 String

발신번호입니다.

text

필수 String

SMS 본문입니다.

ttl

String

메시지가 이통사에 전달되기까지 유효한 최대 시간(초)입니다.

originCID

String

최초 발신사업자 식별코드 입니다.

paymentCode

String

정산용 부서 코드입니다.

groupKey

String

메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.

idempotencyKey

String

요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.

idempotencyTtl

Integer

멱등 처리키 유효시간 입니다.

ref

String

요청 참조 필드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

data

Object

실제 메시지 응답 데이터입니다.

destinations

Object Array

수신자별 처리 결과 배열입니다.

요청 예시

curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "sms": {
        "from": "01000000000",
        "text": "인증번호는 123456 입니다."
      }
    }],
    "ref": "sms-20260330-001"
  }'

응답 예시

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "SMS20260330-000001",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "sms-20260330-001"
  }
}

LMS(장문메시지) 발송

POST/api/comm/v1/send/omni

메시지 발송 체험하기 샌드박스로 테스트하기

장문의 텍스트 안내 발송에 사용합니다. messageFlow[].mms 객체를 사용하며 본문은 최대 2,000byte입니다.

Body Parameters

{}JSON

destinations

필수 Object Array

수신 정보 배열입니다. 동보발송 최대 200건입니다.

필수 String

수신번호입니다.

ref

String

개별 참조 필드입니다.

messageFlow

필수 Object Array

메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.

mms

필수 Object

LMS 메시지 정보입니다.

from

필수 String

발신번호입니다.

title

String

LMS 제목입니다.

text

필수 String

LMS 본문입니다.

ttl

String

메시지가 이통사에 전달되기까지 유효한 최대 시간(초)입니다.

originCID

String

최초 발신사업자 식별코드입니다.

paymentCode

String

정산용 부서 코드입니다.

groupKey

String

메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.

idempotencyKey

String

요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.

idempotencyTtl

Integer

멱등 처리키 유효시간 입니다.

ref

String

요청 참조 필드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

data

Object

실제 메시지 응답 데이터입니다.

destinations

Object Array

수신자별 처리 결과 배열입니다.

요청 예시

curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "mms": {
        "from": "01000000000",
        "title": "주문 안내",
        "text": "주문이 정상 접수되었습니다. 배송은 내일부터 시작됩니다."
      }
    }],
    "ref": "lms-20260330-001"
  }'

응답 예시

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "LMS20260330-000001",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "lms-20260330-001"
  }
}

MMS(이미지+장문메시지) 발송

POST/api/comm/v1/send/omni

메시지 발송 체험하기 샌드박스로 테스트하기

이미지 첨부가 필요한 발송에 사용합니다. messageFlow[].mms.fileKey가 필수이며 본문은 최대 2,000byte입니다.

Body Parameters

{}JSON

destinations

필수 Object Array

수신 정보 배열입니다. 동보발송 최대 200건입니다.

필수 String

수신번호입니다.

ref

String

개별 참조 필드입니다.

messageFlow

필수 Object Array

메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.

mms

필수 Object

MMS 메시지 정보입니다.

from

필수 String

발신번호입니다.

title

String

MMS 제목입니다.

text

필수 String

MMS 본문입니다.

fileKey

필수 String Array

이미지 업로드 후 발급된 파일 키입니다. 이미지 업로드 를 통해 발급받을 수 있습니다.

ttl

String

메시지가 이통사에 전달되기까지 유효한 최대 시간(초)입니다.

originCID

String

최초 발신사업자 식별코드입니다.

paymentCode

String

정산용 부서 코드입니다.

groupKey

String

메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.

idempotencyKey

String

요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.

idempotencyTtl

Integer

멱등 처리키 유효시간 입니다.

ref

String

요청 참조 필드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

data

Object

실제 메시지 응답 데이터입니다.

destinations

Object Array

수신자별 처리 결과 배열입니다.

요청 예시

curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "mms": {
        "from": "01000000000",
        "title": "프로모션 안내",
        "text": "첨부 이미지를 확인해 주세요.",
        "fileKey": ["FILE_KEY_001"]
      }
    }],
    "ref": "mms-20260330-001"
  }'

응답 예시

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "MMS20260330-000001",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "mms-20260330-001"
  }
}

이미지 업로드

POST/api/comm/v1/file/mms

샌드박스로 테스트하기

MMS 발송 시 이미지를 업로드하고 발급된 fileKey를 메시지 본문(messageFlow[].mms.fileKey)에 사용합니다. fileKey는 최대 3개까지 설정할 수 있으며 이미지 순서는 이통사 환경에 따라 보장되지 않습니다.

Body Parameters

FORM-DATA

file

필수Binary

업로드할 이미지 파일 바이너리입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

data

Object

실제 업로드 응답 데이터입니다.

요청 예시

curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/mms" \
  -H "Accept: application/json" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/image.jpg"

응답 예시

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "header-value-X-Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "fileKey": "FILE_KEY_001",
      "expired": "2026-03-30T23: 59: 59+09: 00"
    }
  }
}