뿌리오 - 문자 서비스 1위

뿌리오 문자 연동 전문상담 평일 오전 9시 ~ 오후 5시

070-8707-1469

뿌리오 문자연동 API 서비스란?

별도의 모듈 설치가 필요없이 프로그램 소스에 추가 하여 발송하는 서비스 입니다.

연동 방식 안내

발신자 ( PHP, JSP, ASP etc )

뿌리오 ( API Server )

통신사

수신자 ( SMS / LMS / MMS )

문자 연동 서비스 신청 전 확인해 주세요.

문자 연동 서비스 신청하기 버튼을 눌러주세요.

연동 신청이 승인 완료 시 오픈 API 페이지를 통해 인증 키 발급하세요.

요청 헤더	설명
Authorization	"뿌리오 계정 : 문자연동 개발 인증키”를 Base64 인코딩한 문자열을 전달하는 헤더 Authorization : Basic {Base64 인코딩한 문자열}

요청 헤더	설명
Authorization	엑세스 토큰을 전달하는 헤더, 토큰 타입은 “Bearer”로 고정 Authorization: Bearer {엑세스 토큰}

필드	타입	필수	설명
account	text(20)	O	뿌리오 계정
messageType	text(3)	O	SMS/LMS/MMS * MessageType 기준으로 재화가 차감됩니다.
content	text(2000)	O	메시지 내용 - SMS : 최대 90byte - MMS, LMS : 최대 2000byte
from	text(16)	O	발신번호
duplicateFlag	text(1)	O	수신 번호 중복 여부 - Y : 중복 허용 - N : 중복 제거
targetCount	number	O	수신자 목록 수
targets	array	O	수신자 목록 * 아래 targets 참조
refKey	text(32)	O	요청자가 부여한 키
sendTime	text(19)	X	예약 발송 시간 - yyyy-MM-DDTHH:mm:ss 형태 - 최소 3분 이후, 최대 다음 해 말일 - 요청에서 제외시 즉시 발송
subject	text(30)	X	제목
files	array	X	MMS 발송 시 첨부 파일 * 아래 files 참조

요청 헤더	설명
Authorization	엑세스 토큰을 전달하는 헤더, 토큰 타입은 “Bearer”로 고정 Authorization: Bearer {엑세스 토큰}

필드	타입	필수	설명
account	text(20)	O	뿌리오 계정
messageKey	text(33)	O	메시지 고유 키

필드	타입	필수	설명
code	text(4)	O	응답 코드
description	text	O	응답 메시지

상태 코드	결과 코드	결과 메시지	설명
200	1000	ok	성공
400	2000	(잘못된 파라미터에 따라 다름)	요청이 유효하지 않음
	3001	invalid basic Authentication	토큰 발급 호출 시, Authorization 헤더가 유효하지 않음
	3002	jwt invalid token	토큰이 유효하지 않음
	3003	invalid ip	아이피가 유효하지 않음
	3004	invalid account	계정이 유효하지 않음
	3005	invalid bearer	토큰이 유효하지 않음
	3006	not empty authorization header	Authorization 헤더가 유효하지 않음
	3007	jwt token issuance failed	엑세스 토큰 발행 실패
	3008	too many request	너무 많은 요청 (Rate-Limit 관련)
	4004	inactive account	api 접근 권한이 비활성화 상태
	4006	invalid auth key	인증키가 유효하지 않음
	4007	not issued auth key	인증키를 발행 받지 않음
	4009	invalid message key	취소를 위한 messageKey가 유효하지 않음
	4010	the deadline for canceling has expired	예약 취소 가능 시간이 지남
	4011	the message has already been sent	메시지가 이미 발송중인 상태
	4012	the reservation cannot be canceled	예약을 취소할 수 없음
500	9000 ~ 9999	internal server error	서버 오류