입력한 메시지 타입의 규격을 어겨서 전송한 경우 글자수가 잘리거나 이미지가 미전송될 수 있습니다.
[SMS] : 메시지 길이 최대 90Byte (치환변수 포함)
[LMS/MMS] : 메시기 길이 최대 2,000Byte (치환변수 포함)
[MMS 이미지 규격] :
1500×1440px 미만, jpg/jpeg 파일만 가능, 개당 최대 500KB,
복수의 이미지 첨부 시 총합 크기가 1MB 미만
1.2 Request Body Parameters
{
"svcKndCd": "SMS",
"msgCotn": "api sms test",
"adIncluYn": "N",
"snPhnum": "1234-1234",
"messageReceiverList": [
{
"mbnum": "010-xxxx-xxxx"
}
],
"rsvDtt" : "2024-09-04 18:18"
}
{
"svcKndCd": "SMS",
"msgCotn": "api sms test",
"adIncluYn": "N",
"snPhnum": "1234-1234",
"addrNmList" : [
"SMS 주소록1",
"SMS 주소록2"
]
"fileId" : "1ee7ehhjjhg1hghj22464h"
}
{
"svcKndCd": "SMS",
"msgCotn": "api sms test 광고",
"snPhnum": "1234-1234",
"messageReceiverList": [
{
"mbnum": "010-xxxx-xxxx"
}
]
,"adIncluYn": "Y"
,"entprNm": "megabird"
,"useDefault080": false
,"blockedPhnum": "08012341234"
,"blockedDstKey": "11111111"
}
{
"svcKndCd": "LMS",
"msgCotn": "api lms test #{이름}, #{1}, #{2}, #{3}, #{4}",
"adIncluYn": "N",
"snPhnum": "1234-1234",
"messageReceiverList": [
{
"mbnum": "010-xxxx-xxxx"
,"tgusNm" : "김철수"
,"var1Vl" : "변수1"
,"var2Vl" : "변수2"
,"var3Vl" : "변수3"
,"var4Vl" : "변수4"
}
]
}
{
"svcKndCd": "MMS",
"msgTtl": "mms 제목",
"msgCotn": "mms 내용",
"image1FileId": "b6180bf8a8014fde8d20cf7ad9341e23",
"image2FileId": "08283f5b81f145b99ac6499d5cfb9f66",
"image3FileId": "f14ed4c0d654496788808a0add09dfa2",
"adIncluYn": "N",
"snPhnum": "1234-1234",
"messageReceiverList": [
{
"mbnum": "010-xxxx-xxxx"
}
]
}
{
"success": true,
"code": "200",
"message": "성공",
"data": {
"msgGrpNo": 123456
},
"timestamp": "2024-01-01T15:12:10.902849"
}
{
"status": 400,
"code": 3100,
"message": "유효성 검사에 실패하였습니다.",
"success": false,
"timestamp": "2024-01-01T15:33:20.070171",
"description": [
{
"code": "Size",
"field": "messageReceiverList[0].var1Vl",
"errorType": "field",
"message": "변수1값은 최대 30자입니다."
}
]
}
{
"status": 400,
"code": 6129,
"message": "MMS일 경우 이미지 파일이 포함되어야 합니다. 이미지 파일이 없으시면 LMS를 이용하시기 바랍니다.",
"success": false,
"timestamp": "2024-01-01T14:43:50.333882",
"description": [
{
"field": "svcKndCd",
"errorType": "field",
"message": "서비스구분코드(svcKndCd)가 MMS일 경우 이미지 파일을 첨부하시기 바랍니다."
}
]
}
200 , "성공"
1001, "시스템 에러가 발생하였습니다."
2001, "엑셀파일 확장자는 xls, xlxs만 허용됩니다.."
2002, "업로드 허용사이즈는 최대 100,000건입니다."
2003, "전체 컬럼의 데이터 총 개수가 일치하지 않습니다."
2004, "엑셀 업로드 파일 사이즈는 최대 50Mb입니다."
2100, "회원 아이디는 최대 10글자입니다."
3100, "유효성 검사에 실패하였습니다."
3101, "유효성 검사에 실패하였습니다."
3102, "입력 파라미터 포맷에 오류가 있습니다."
4101, "회원정보가 존재하지 않거나 등록상태가 유효하지 않습니다."
4102, "등록된 발신번호가 존재하지 않습니다."
5001, "그룹을 추가할 수 없습니다. 그룹은 최대 100개까지 등록 가능합니다."
5002, "중복된 그룹명이 존재합니다. 중복된 그룹명은 사용하실 수 없습니다."
5003, "존재하지 않는 그룹번호 입니다."
5004, "한 그룹 내 최대 번호 저장 건수인 10만건을 초과했습니다. 번호를 추가할 수 없습니다."
5005, "주소그룹번호 혹은 주소그룹명은 필수 입력 항목입니다."
5006, "삭제할 수 없는 그룹입니다."
6001, "존재하지 않는 KEY 입니다."
6002, "정지된 KEY 입니다."
6003, "허용되지 않은 IP 입니다."
6004, "등록되지 않은 파일아이디입니다."
6005, "파일업로드 데이터를 가져오는 중 오류가 발생했습니다."
6101, "허용되지 않은 채널명 입니다."
6102, "등록되지 않은 템플릿 아이디 입니다."
6103, "서비스구분코드는 필수 값입니다."
6104, "서비스구분코드는 SMS, LMS, MMS만 가능합니다."
6105, "서비스구분코드는 MMS만 가능합니다."
6106, "메시지내용은 필수 값입니다."
6107, "단가 정보를 불러오지 못했습니다."
6108, "수신전화번호는 최소 1개 이상 필수 값입니다."
6109, "발신전화번호는 숫자만 가능합니다."
6110, "SMS는 최대 90Byte까지 입력 가능합니다."
6111, "메시지내용은 최대 2,000byte까지 입력 가능합니다."
6112, "1일 최대 발송한도를 초과했습니다."
6113, "발송시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다. 야간 발송제한시간에는 광고문자를 발송할 수 없습니다."
6114, "광고포함여부는 필수 값입니다."
6115, "광고성 정보 메시지의 경우 서비스(업체)명은 필수 값입니다."
6116, "이미지 파일은 500KB 이하의 jpg, jpeg 파일만 가능합니다."
6117, "이미지 파일은 500KB 이하의 jpg, png 파일만 가능합니다."
6118, "png 이미지 파일은 대체문자 전송이 불가능합니다."
6119, "대체문자의 메시지내용은 필수 값입니다."
6120, "대체문자의 메시지구분코드는 필수 값입니다."
6121, "대체문자의 발신전화번호는 필수 값입니다."
6122, "대체문자의 발신전화번호는 숫자만 가능합니다."
6123, "알림톡 대체문자의 메시지구분코드는 SMS, LMS 가능합니다."
6124, "친구톡(텍스트) 대체문자의 메시지구분코드는 SMS, LMS 가능합니다."
6125, "친구톡(포토) 대체문자의 메시지구분코드는 MMS 가능합니다."
6126, "등록된 발신번호가 아닙니다. \n발신번호를 먼저 등록해주시기 바랍니다."
6127, "해당 발신번호는 스팸차단 되었습니다. \n고객센터로 문의하시기 바랍니다."
6128, "해당 메시지 내용중에 스팸차단된 문구를 포함하고 있으므로 \n발송하실 수 없습니다."
6129, "MMS일 경우 이미지 파일이 포함되어야 합니다. 이미지 파일이 없으시면 LMS를 이용하시기 바랍니다."
6300, "예약시간을 다시 설정해주세요.\n현재로부터 10분 이후의 시점부터 예약할 수 있습니다."
6301, "예약시간을 다시 설정해주세요.\n현재로부터 30일 이내의 시점까지 예약할 수 있습니다."
6302, "예약하신 시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다.\n야간 발송제한시간에는 광고문자를 발송할 수 없습니다."
6303, "발송시간이 심야 시간(21:00 ~ 익일 08:00)에 해당합니다.\n야간 발송제한시간에는 광고문자를 발송할 수 없습니다."
6304, "예약 발송건이 아닙니다."
6305, "예약시간을 다시 설정해주세요.\n발송 예정 일시 10분 전에는 예약을 취소 및 수정 할 수 없습니다."