API Reference
메시지 발송
SMS/LMS/MMS 메시지를 발송합니다. From 번호는 계정에 등록된 번호여야 합니다.
KCT 통합메시징 Agent를 통해 실제 발송되며, 발송 결과는 webhook으로 비동기 수신합니다.
메시지 타입별 사용법
SMS (단문, 200byte 이하):
{ "To": "010...", "From": "070...", "Body": "안녕하세요" }LMS (장문, 2000자 이하, 첨부 없음):
{ "To": "010...", "From": "070...", "Body": "긴 내용...", "Type": "lms", "Subject": "제목" }MMS (이미지 첨부, 최대 3개):
{ "To": "010...", "From": "070...", "Body": "사진", "Type": "mms", "MediaUrl": ["https://example.com/photo.jpg"] }Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/messages" \ -H "Content-Type: application/json" \ -d '{ "To": "01012345678", "From": "07052358010", "Body": "안녕하세요" }'{
"messageId": "MGabcdef1234567890",
"status": "queued",
"type": "sms",
"subject": "string",
"to": "01012345678",
"from": "07052358010",
"body": "안녕하세요",
"numMedia": 0,
"mediaUrl": [],
"direction": "outbound",
"accountId": "AC1a2b3c4d",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z"
}{
"error": "string",
"code": "INVALID_PHONE_NUMBER"
}{
"error": "string",
"code": "INVALID_PHONE_NUMBER"
}{
"error": "string",
"code": "INVALID_PHONE_NUMBER"
}{
"error": "string",
"code": "INVALID_PHONE_NUMBER"
}