톡 스튜디오 · LMS 단건 발송
LMS 단건 발송
승인된 발신번호로 LMS(장문) 1건을 발송하는 API입니다. 발송 접수 후 통신사 전송은 순차적으로 처리됩니다.
LMS 단건 발송
승인된 발신번호로 LMS(장문) 1건을 발송하는 API입니다. 발송 접수 후 통신사 전송은 순차적으로 처리됩니다.
요청 파라미터
| 이름 | 타입 | 필수 | 기본값 | 조건 | 설명 |
|---|---|---|---|---|---|
from |
string | 필수 | - | - | 발신번호입니다. 워크스페이스에 승인 등록된 번호만 사용할 수 있습니다. |
to |
string | 필수 | - | - | 수신번호입니다. |
subject |
string | 선택 | 제목 없음 |
- | LMS 제목입니다. 비우면 제목 없이 발송됩니다. |
text |
string | 필수 | - | - | LMS 본문입니다. EUC-KR 기준 2,000바이트 이하만 가능합니다. |
is_ad |
boolean | 선택 | false |
- | 광고 문자 여부입니다. true면 (광고)·무료수신거부 문구가 자동으로 부착되고 08~20시에만 발송됩니다. |
optout_number |
string | 선택 | |
- | 무료수신거부 080 번호입니다. 광고 문자에서만 사용하며, 미지정 시 워크스페이스 등록 번호 또는 공용 번호가 적용됩니다. |
reserve_dttm |
string | 선택 | |
YYYY-MM-DD HH:mm:ss | 예약 발송 시각입니다. 미래 시각이면 예약, 과거이거나 비우면 즉시 발송됩니다. |
idem_key |
string | 선택 | |
- | 멱등키입니다. 같은 키로 다시 접수하면 중복 발송·중복 차감 없이 기존 접수를 그대로 반환합니다. |
응답 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
traceId
|
string | 요청 추적 ID입니다. |
code
|
string | 응답 코드입니다. 성공은 000000입니다. |
message
|
string | 응답 메시지입니다. |
send_key
|
string | 발송 접수 key입니다. 발송 상태 조회에 사용합니다. |
count
|
integer | 접수된 수신자 수입니다. |
요청 예시
예시 생성 중…
응답 예시 성공
{
"traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
"code": "000000",
"message": "성공",
"send_key": "a1b2c3d4e5f6a7b8c9d0",
"count": 1
}