Index

1. 발신번호 사전등록

1.1. GetSenderNumberMgtURL - 발신번호 관리 팝업 URL

ㆍ 문자 발신번호 관리 팝업 URL을 반환합니다.

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

string GetSenderNumberMgtURL(string CorpNum, string UserID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

1.2. GetSenderNumberList - 발신번호 목록 확인

ㆍ 팝빌에 등록된 문자 발신번호 목록을 반환합니다.

List<SenderNumber> GetSenderNumberList(string CorpNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

List<SenderNumber>

Throws

PopbillException

2. 문자전송

접수번호(recieptNum)

  • 작업(접수) 단위를 나타내는 고유한 식별정보로 문자 전송 함수 호출시 팝빌로부터 반환받는 값
  • 예약접수 건을 취소하거나, 전송내역 및 실패사유를 확인하기 위한 값

cf. 다건접수(대량/동보) 경우에도 하나의 접수번호만을 반환

2.1. SendSMS - 단문 단건전송

ㆍ 단문(SMS) 메시지를 전송합니다.

ㆍ 메시지 길이가 90byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendSMS(string CorpNum, string snd, string sndnm, string rcv, string rcvnm, string content, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 sndnm string 70 - 발신자명
4 rcv string 70 - 수신번호
5 rcvnm string 70 - 수신자명
6 content string 90 - 메시지 내용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
7 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
8 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
9 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
10 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.2. SendSMS - 단문 (개별내용 대량전송)

ㆍ 단문(SMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 메시지 길이가 90byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendSMS(string CorpNum, string snd, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
4 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
5 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
6 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
7 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.3. SendSMS - 단문 (동일내용 대량전송)

ㆍ 단문(SMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 메시지 길이가 90byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendSMS(string CorpNum, string snd, string content, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 - [동보] 발신번호, 전송정보에 발신번호 없는 경우 적용
3 content string 90 - [동보] 메시지 내용, 전송정보에 메시지 내용 없는 경우 적용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
4 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
5 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
6 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
7 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
8 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.4. SendLMS - 장문 단건전송

ㆍ 장문(LMS) 메시지를 전송합니다.

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

public string SendLMS(string CorpNum, string snd, string sndnm, string rcv, string rcvnm, string subject, string content, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 sndnm string 70 - 발신자명
4 rcv string 70 - 수신번호
5 rcvnm string 70 - 수신자명
6 subject string 40 - 메시지 제목
7 content string 90 - 메시지 내용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
8 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
9 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
10 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
11 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.5. SendLMS - 장문 (개별내용 대량전송)

ㆍ 장문(LMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendLMS(string CorpNum, string snd, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
4 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
5 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
6 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
7 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.6. SendLMS - 장문 (동일내용 대량전송)

ㆍ 장문(LMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendLMS(string CorpNum, string snd, string subject, string content, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 - [동보] 발신번호, 전송정보에 발신번호 없는 경우 적용
3 subject string 40 - [동보] 메시지 제목, 전송정보에 메시지 제목 없는 경우 적용
4 content string 90 - [동보] 메시지 내용, 전송정보에 메시지 내용 없는 경우 적용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
5 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
6 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
7 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
8 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
9 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.7. SendMMS - 포토문자 단건전송

ㆍ 포토(MMS) 메시지를 전송합니다.

ㆍ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG), 가로/세로 1000px 이하 권장

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendMMS(string CorpNum, string snd, string sndnm, string rcv, string rcvnm, string subject, string content, string mmsfilepath, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 sndnm string 70 - 발신자명
4 rcv string 70 - 수신번호
5 rcvnm string 70 - 수신자명
6 subject string 40 - 메시지 제목
7 content string 90 - 메시지 내용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
8 mmsfilepath string - O 전송파일 경로
9 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
10 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
11 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
12 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.8. SendMMS - 포토문자 (개별내용 대량전송)

ㆍ 포토(MMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG), 가로/세로 1000px 이하 권장

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendMMS(string CorpNum, string snd, List<Message> messages, string mmsfilepath, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
4 mmsfilepath string - O 전송파일 경로
5 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
6 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
7 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
8 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.9. SendMMS - 포토문자 (동일내용 대량전송)

ㆍ 포토(MMS) 메시지를 전송합니다. (최대 1000건)

ㆍ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG), 가로/세로 1000px 이하 권장

ㆍ 메시지 길이가 2000 byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 제거됩니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendMMS(string CorpNum, string snd, string subject, string content, List<Message> messages, string mmsfilepath, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 - [동보] 발신번호, 전송정보에 발신번호 없는 경우 적용
3 subject string 40 - [동보] 메시지 제목, 전송정보에 메시지 제목 없는 경우 적용
4 content string 90 - [동보] 메시지 내용, 전송정보에 메시지 내용 없는 경우 적용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
5 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
6 mmsfilepath string - O 전송파일 경로
7 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
8 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
9 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
10 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.10. SendXMS - 단문/장문 자동인식 단건전송

ㆍ 메시지 내용의 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동인식하여 전송합니다.

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendXMS(string CorpNum, string snd, string sndnm, string rcv, string rcvnm, string subject, string content, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 sndnm string 70 - 발신자명
4 rcv string 70 - 수신번호
5 rcvnm string 70 - 수신자명
6 subject string 40 - 메시지 제목
7 content string 90 - 메시지 내용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
8 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
9 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
10 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
11 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.11. SendXMS - 단문/장문 자동인식 (개별내용 대량전송)

ㆍ 메시지 내용의 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동인식하여 전송합니다. (최대 1000건)

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendXMS(string CorpNum, string snd, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 O 발신번호
3 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
4 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
5 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
6 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
7 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.12. SendXMS - 단문/장문 자동인식 (동일내용 대량전송)

ㆍ 메시지 내용의 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동인식하여 전송합니다. (최대 1000건)

ㆍ 팝빌에 등록되지 않은 발신번호로 메시지를 전송하는 경우 발신번호 미등록 오류로 처리됩니다.

string SendXMS(string CorpNum, string snd, string subject, string content, List<Message> messages, DateTime? sndDT = null, bool adsYN = false, string requestNum = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 snd string 20 - [동보] 발신번호, 전송정보에 발신번호 없는 경우 적용
3 subject string 40 - [동보] 메시지 제목, 전송정보에 메시지 제목 없는 경우 적용
4 content string 90 - [동보] 메시지 내용, 전송정보에 메시지 내용 없는 경우 적용
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
5 messages List<Message> 1000 O [배열] 전송 정보 (최대 1,000건)
6 sndDT DateTime? 14 - 예약일시, 날짜형식(yyyyMMddHHmmss)
- null인 경우 즉시 전송
7 adsYN bool - O 광고메시지 전송여부
[참고] "광고메시지 전송방법 안내" - http://blog.linkhub.co.kr/2642/
8 requestNum string 36 - 전송요청번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
9 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.13. CancelReserve - 예약전송 취소

ㆍ 예약문자 전송을 취소합니다.

ㆍ 예약취소는 예약시간 10분전까지 가능합니다.

Response CancelReserve(string CorpNum, string receiptNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 receiptNum string 18 O 예약문자 전송요청시 발급받은 접수번호
3 UserID string 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

2.14. CancelReserveRN - 예약전송 취소 (요청번호 할당)

ㆍ 예약문자 전송을 취소합니다.

ㆍ 예약취소는 예약시간 10분전까지 가능합니다.

Response CancelReserveRN(string CorpNum, string requestNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 requestNum string 36 O 예약문자 전송요청시 할당한 전송요청번호
3 UserID string 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

3. 정보확인

3.1. GetMessages - 전송내역 확인

ㆍ 문자 전송상태 및 결과정보를 확인합니다.

List<MessageResult> GetMessages(string CorpNum, string receiptNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 receiptNum string 18 O 문자 전송요청시 발급받은 접수번호
3 UserID string 50 - 팝빌회원 아이디

Return

List<MessageResult>

Throws

PopbillException

3.2. GetMessagesRN - 전송내역 확인 (요청번호 할당)

ㆍ 문자 전송상태 및 결과정보를 확인합니다.

List<MessageResult> GetMessagesRN(string CorpNum, string requestNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 requestNum string 36 O 문자 전송요청시 할당한 전송요청번호
3 UserID string 50 - 팝빌회원 아이디

Return

List<MessageResult>

Throws

PopbillException

3.3. GetStates - 전송내역 요약정보 확인

ㆍ 문자 전송상태 및 결과정보에 대한 요약정보를 확인합니다.

List<MessageState> GetStates(string CorpNum, List<string> ReciptNumList, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 ReciptNumList List<string> 18 O [배열] 문자전송 접수번호 배열 (최대 1,000건)
3 UserID string 50 - 팝빌회원 아이디

Return

List<MessageState>

Throws

PopbillException

3.4. Search - 전송내역 목록 조회

ㆍ 검색조건에 해당하는 문자 전송내역 목록을 조회합니다. (최대 검색기간 : 6개월 이내)

MSGSearchResult Search(string CorpNum, string SDate, string EDate, string[] State = null, string[] Item = null, bool? ReserveYN = false, bool? SenderYN = false, int? Page = null, int? PerPage = null, string Order = null, string QString = null, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 SDate string 8 O 시작일자, 날짜형식(yyyyMMdd)
3 EDate string 8 O 종료일자, 날짜형식(yyyyMMdd)
4 State string[] - - [배열] 전송상태 [ 1-대기 / 2-성공 / 3-실패 / 4-취소 ]
5 Item string[] - - [배열] 검색대상 [ SMS-단문 / LMS-장문 / MMS-포토 ]
6 ReserveYN bool - - 예약여부 [ False-전체조회, True-예약전송건 조회 ]
7 SenderYN bool - - 개인조회 여부 [ False-전체조회, True-개인조회 ]
8 Page int? - - 페이지번호, 기본값 '1'
9 PerPage int? - - 페이지당 검색개수, 기본값 500, 최대 1000
10 Order string 1 - 정렬 방향, 기본값 'D' [ D-내림차순, A-오름차순 중 택1 ]
11 QString string - - 발신자명 또는 수신자명 검색조회, 공백처리시 전체조회
12 UserID string 50 - 팝빌회원 아이디

Return

MSGSearchResult

Throws

PopbillException

3.5. GetSentListURL - 문자 전송내역 팝업 URL

ㆍ 문자 전송내역 팝업 URL을 반환합니다.

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

string GetSentListURL(string CorpNum, string UserID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

3.6. GetAutoDenyList - 080 수신거부 목록 확인

ㆍ 080 수신거부 목록을 반환합니다.

List<AutoDeny> GetAutoDenyList(string CorpNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

List<AutoDeny>

Throws

PopbillException

4. 포인트 관리

4.1. GetBalance - 연동회원 잔여포인트 확인

ㆍ연동회원의 잔여포인트를 확인합니다.

Double GetBalance(string CorpNum)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)

Return

Double - 연동회원 잔여포인트

Throws

PopbillException

4.2. GetChargeURL - 연동회원 포인트 충전 팝업 URL

ㆍ연동회원 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

string GetChargeURL(string CorpNum, string UserID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 O 팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

4.3. GetPartnerBalance - 파트너 잔여포인트 확인

ㆍ파트너의 잔여포인트를 확인합니다.

Double GetPartnerBalance(string CorpNum)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)

Return

Double - 파트너 잔여포인트

Throws

PopbillException

4.4. GetPartnerURL - 파트너 포인트충전 팝업 URL

ㆍ파트너 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

string GetPartnerURL(string CorpNum, string TOGO)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 TOGO string - O CHRG : 파트너 포인트 충전

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

4.5. GetUnitCost - 발행 단가 확인

ㆍ문자 전송시 과금되는 포인트 단가를 확인합니다.

Single GetUnitCost(string CorpNum, MessageType msgType, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 msgType MessageType - O 문자전송 유형 : SMS / LMS / MMS 중 택 1
└ SMS = 단문, LMS = 장문, MMS = 포토문자
3 UserID string 50 - 팝빌회원 아이디

Return

Single - 문자 전송 단가

Throws

PopbillException

4.6. GetChargeInfo - 과금정보 확인

ㆍ팝빌 문자 API 서비스 과금정보를 확인합니다.

ChargeInfo GetChargeInfo(string CorpNum, MessageType msgType, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 msgType MessageType - O 문자전송 유형 : SMS / LMS / MMS 중 택 1
└ SMS = 단문, LMS = 장문, MMS = 포토문자
3 UserID string 50 - 팝빌회원 아이디

Return

ChargeInfo

Throws

PopbillException

5. 회원정보

5.1. CheckIsMember - 연동회원 가입여부 확인

ㆍ사업자번호를 조회하여 연동회원 가입여부를 확인합니다.

Response CheckIsMember(string CorpNum, string LinkID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 LinkID string - O 연동신청시 팝빌에서 발급받은 링크아이디

Return

Response

Throws

PopbillException

5.2. CheckID - 아이디 중복 확인

ㆍ사용하고자 하는 아이디의 중복여부를 확인합니다.

Response CheckID(string ID)

Parameters

순번 변수명 타입 길이 필수 설명
1 ID string 10 O 중복여부를 확인할 아이디

Return

Response

Throws

PopbillException

5.3. JoinMember - 연동회원 신규가입

ㆍ사용자를 연동회원으로 가입처리합니다.

Response JoinMember(JoinForm joinInfo)

Parameters

순번 변수명 타입 길이 필수 설명
1 joinInfo JoinForm - O 연동회원 객체정보

Return

Response

Throws

PopbillException

5.4. GetAccessURL - 팝빌 로그인 팝업 URL

ㆍ팝빌 사이트에 로그인 상태로 접근할 수 있는 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

string GetAccessURL(string CorpNum, string UserID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 O 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

5.5. GetCorpInfo - 회사정보 확인

ㆍ연동회원의 회사정보를 확인합니다.

CorpInfo GetCorpInfo(string CorpNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

CorpInfo

Throws

PopbillException

5.6. UpdateCorpInfo - 회사정보 수정

ㆍ연동회원의 회사정보를 수정합니다.

Response UpdateCorpInfo(string CorpNum, CorpInfo corpInfo, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 corpInfo CorpInfo - O 회사 객체정보
3 UserID string 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

5.7. RegistContact - 담당자 추가

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정)를 추가합니다.

Response RegistContact(string CorpNum, Contact contactInfo, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 contactInfo Contact - O 담당자 객체정보
3 UserID string 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

5.8. ListContact - 담당자 목록 확인

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 목록을 확인합니다.

List<Contact> ListContact(string CorpNum, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디

Return

List<Contact>

Throws

PopbillException

5.9. UpdateContact - 담당자 정보 수정

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 정보를 수정합니다.

Response UpdateContact(string CorpNum, Contact contactInfo, string UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 contactInfo Contact - O 담당자 객체정보
3 UserID string 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

A. 객체정보

A.1. Response

순번 변수명 항목명 타입 길이 비고
1 code 코드 long - API 처리에 대한 응답 상태코드
2 message 메시지 string - API 처리에 대한 응답 메시지

A.2. PopbillException

순번 변수명 항목명 타입 길이 비고
1 code 코드 long - API 처리 실패에 대한 오류코드(-로 시작하는 8자리 숫자값)
2 Message 메시지 string - API 처리 실패에 대한 오류메시지

A.3. SenderNumber

순번 변수명 항목명 타입 길이 비고
1 number 발신번호 string 20
2 representYN 대표번호 지정여부 bool? -
3 state 등록일시 int? 1 등록상태 [ 0-대기 / 1-승인 / 2-취소 ]

A.4. MessageType (enum)

순번 변수명 항목명 타입 길이 비고
1 SMS 단문 enum -
2 LMS 장문 enum -
3 MMS 포토 enum -
4 XMS 단문/장문 enum -

A.5. Message

순번 변수명 항목명 타입 길이 필수 비고
1 sendNum 발신번호 string 20 O
2 senderName 발신자명 string 70 -
3 receiveNum 수신번호 string 20 -
4 receiveName 수신자명 string 70 -
5 content 메시지 내용 string 단문 90
장문 2000
단위 : byte
- 한글,한자,특수문자 2byte / 영문,숫자 1byte
6 subject 메시지 제목 string 40 - 장문/포토문자 전송에만 메시지 제목 사용 가능

A.6. MSGSearchResult

순번 변수명 항목명 타입 길이 비고
1 code 요청에 대한 응답코드 int -
2 message 요청에 대한 응답메시지 string -
3 total 총 검색결과 건수 int -
4 perPage 페이지당 검색개수 int -
5 pageNum 페이지 번호 int -
6 pageCount 페이지 개수 int -
7 list 전송결과 정보 List<MessageResult> [리스트] 최대 1,000개, 전송내역 확인(GetMessages API) 응답전문의 구성과 동일

A.7. MessageResult

순번 변수명 항목명 타입 길이 비고
1 subject 메시지 제목 string 40
2 content 메시지 내용 string 단문 90
장문 2000
단위 : byte
3 sendNum 발신번호 string 20
4 senderName 발신자명 string 70
5 receiveNum 수신번호 string 20
6 receiveName 수신자명 string 70
7 receiptDT 접수일시 string 14
8 sendDT 전송일시 string 14
9 resultDT 전송결과 수신일시 string 14
10 reserveDT 예약일시 string 14
11 state 전송 상태코드 int? 1 [부록] "전송 코드 테이블"
12 result 전송 결과코드 int? 3
13 type 메시지 타입 string 3
14 tranNet 전송처리 이동통신사명 string 3
15 receiptNum 접수번호 string 18
16 requestNum 요청번호 string 36

A.8. MessageState

순번 변수명 항목명 타입 길이 비고
1 sn 일련번호 string -
2 rNum 접수번호 String 18
3 stat 전송 상태코드 String 1 [부록] "전송 코드 테이블"
4 sDT 전송일시 string -
5 rDT 전송결과 수신일시 string -
6 rlt 전송 결과코드 String 3 [부록] "전송 코드 테이블"
7 net 전송 이동통신사명 string -
8 srt 구 전송결과 코드 string -

A.9. AutoDeny

순번 변수명 항목명 타입 길이 비고
1 number 수신거부번호 string 20
2 regDT 등록일시 string 14

A.10. ChargeInfo

순번 변수명 항목명 타입 길이 비고
1 unitCost 전송단가 string - 전송단가 반환
2 chargeMethod 과금유형 string - 일반, 연동, 파트너 중 반환
3 rateSystem 과금제도 string - 종량제 반환

A.11. JoinForm

순번 변수명 항목명 타입 길이 필수 비고
1 ID 아이디 string 50 O 6자 이상 50자 미만
2 PWD 비밀번호 string 20 O 6자 이상 20자 미만
3 LinkID 파트너 링크아이디 string 20 O 파트너 신청시 메일로 발급받은 링크아이디
4 CorpNum 사업자번호 string 10 O 사업자번호 (하이픈 '-' 제외 10 자리)
5 CEOName 대표자 성명 string 100 O
6 CorpName 상호 string 200 O
7 Addr 사업장 주소 string 300 O
8 BizType 업태 string 100 O
9 BizClass 종목 string 100 O
10 ContactName 담당자 성명 string 100 O
11 ContactEmail 담당자 이메일 string 100 O
12 ContactTEL 담당자 연락처 string 20 O
13 ContactHP 담당자 휴대폰번호 string 20 -
14 ContactFAX 담당자 팩스번호 string 20 -

A.12. CorpInfo

순번 변수명 항목명 타입 길이 필수 비고
1 ceoname 대표자 성명 string 100 O
2 corpName 상호 string 200 O
3 addr 주소 string 300 O
4 bizType 업태 string 100 O
5 bizClass 종목 string 100 O

A.13. Contact

순번 변수명 항목명 타입 길이 필수 비고
1 id 아이디 string 50 O 6자 이상 50자 미만
2 pwd 비밀번호 string 20 O 6자 이상 20자 미만
3 personName 담당자 성명 string 100 O
4 tel 담당자 연락처 string 20 -
5 hp 담당자 휴대폰번호 string 20 -
6 fax 담당자 팩스번호 string 20 -
7 email 담당자 이메일 string 100 O
8 regDT 등록일시 string 14 -
9 searchAllAllowYN 담당자 조회권한 설정 bool? - O 회사조회(True) : 모든 담당자의 문자 전송내역 조회가능
개인조회(False) : 해당 담당자 계정으로 전송한 문자 전송내역 조회가능
10 mgrYN 관리자 여부 bool? - O True-관리자 / False-사용자
11 state 상태 string 1 - 0–승인대기 / 1–사용중