뿌리오 문자연동 API 서비스란? 별도의 모듈 설치가 필요없이 웹URL호출만으로 간단히 프로그램 소스에 추가하여 발송하는 서비스 입니다.
1. 뿌리오 발송API 경로
| 구분 | UTF-8 인코딩 버전 | EUC-KR 인코딩 | |
|---|---|---|---|
| JSON | 발송 | https://message.ppurio.com/api/send_utf8_json.php | https://message.ppurio.com/api/send_euckr_json.php |
| 취소 | https://message.ppurio.com/api/cancel_utf8_json.php | https://message.ppurio.com/api/cancel_euckr_json.php | |
XML |
발송 | https://message.ppurio.com/api/send_utf8_xml.php | https://message.ppurio.com/api/send_euckr_xml.php |
| 취소 | https://message.ppurio.com/api/cancel_utf8_xml.php | https://message.ppurio.com/api/cancel_euckr_xml.php | |
TEXT |
발송 | https://message.ppurio.com/api/send_utf8_text.php | https://message.ppurio.com/api/send_euckr_text.php |
| 취소 | https://message.ppurio.com/api/cancel_utf8_text.php | https://message.ppurio.com/api/cancel_euckr_text.php | |
2. 요청값 정의
| 구분 | 상세설명 |
|---|---|
| userid | (필수) 뿌리오 가입 아이디 |
| callback | (필수) 승인된 발신번호 (숫자만) |
| phone | (필수) 수신번호 : 대량 발송시, |로 구분 '010********|010********|010********' |
| msg | (필수) 메시지 내용 : 이름(names)값이 있다면 [*이름*]가 치환 발송 가능 |
| names | [선택] 이름 - 여러명일 경우, |로 구분 '홍길동|이순신|김철수' |
| appdate | [선택] 예약발송 (현재시간 기준 10분이후 예약가능) |
| subject | [선택] 제목 (30byte)이내 가능 |
| file1 | [선택] 포토이미지 추가 (jpg, jpeg만 지원 300 Kbyte 이하) |
3. 응답값 정의
| 구분 | 상세설명 |
|---|---|
| (예시) ok|sms|01012345678|1 | 전송결과(ok:성공)|발송형태(sms /lms/mms)|발송 msgid (예약취소시 필요)|발송건수 |
| invalid_member | 연동서비스 이용불가 아이디 |
| under_maintenance | 발송요청 시간에 서버점검 인 경우 |
| allow_https_only | http 요청인 경우 |
| invalid_ip | 등록된 IP가 아닌 경우 |
| invalid_msg | 메시지 내용 오류 |
| invalid_names | 이름 오류 |
| invalid_subject | 제목 오류 |
| invalid_sendtime | 예약발송 시간에 오류 (10분이후 부터 다음해말까지 가능) |
| invalid_sendtime_maintenance | 예약 발송시간내에 서버점검 인 경우 |
| invalid_phone | 수신번호 오류 |
| invalid_msg_over_max | 메시지 내용 byte 초과 |
| invalid_callback | 발신번호 상태 오류 |
| once_limit_over | 1회 최대 발송건수 초과 |
| daily_limit_over | 1일 최대 발송건수 초과 |
| not_enough_point | 발송금액 부족 |
| over_use_limit | 한달 사용금액을 초과한 경우 |
| server_error | 기타 서버 오류 |
| invalid_msgid | 발송 msgid 오류 |
| master_not_exist | 취소할 발송 msgid가 없는 경우 |
| not_update_time | 예약시간이 1분이내여서 취소가 불가능한 경우 |
| ing_master | 이미 발송중인 경우 |
