PUSH 방식
발송 결과 전달
발송 결과는 고객사에서 사전에 등록 요청한 URL로 PUSH 방식으로 전달됩니다.
Request
Header
POST {고객사에서 등록 요청한 URL} HTTP/1.1
Content-type: application/json
Body
키 | 필수 | 설명 |
DEVICE | Y | 메시지 유형 |
CMSGID | Y | 메시지 키 |
MSGID | Y | 비즈뿌리오 메시지 키 |
PHONE | Y | 수신 번호 |
MEDIA | Y | 실체 발송된 메시지 상세 유형 * MEDIA 유형 |
TO NAME | N | 수신자 명 |
UNIXTIME | Y | 발송 시간 |
RESULT | Y | 이통사/카카오/RCS 결과 코드 * 발송 결과 코드 참조 |
USERDATA | N | 정산용 부서 코드 |
WAPINFO | N | 이통사/카카오 정보 * SKT/KTF/LGT/KAO |
TELRES | N | 이통사 대체 발송 결과 |
TELTIME | N | 이통사 대체 발송 시간 |
KAORES | N | 카카오 대체 발송 결과 |
KAOTIME | N | 카카오 대체 발송 시간 |
RCSRES | N | RCS 대체 발송 결과 |
RCSTIME | N | RCS 대체 발송 시간 |
RETRY_FLAG | N | 대체 발송 정보 |
RESEND_FLAG | N | 대체 발송 메시지 유형 |
REFKEY | N | 고객사에서 부여한 키 |
예시)
{
"DEVICE": "SMS",
"CMSGID": "201027134355944sms027420servqer0",
"MSGID": "1027se_SL4676027383600490148",
"PHONE": "01000000000",
"MEDIA": "SMS",
"UNIXTIME": "1603773837",
"RESULT": "4100",
"USERDATA": "daoutech",
"WAPINFO": "SKT",
"REFKEY" : "smstest00001"
}
MEDIA 유형
분류 | 설명 |
SMS | 국내 SMS 발송 |
ISM | 국제 SMS 발송 |
VDO | 비디오 발송 |
MMS | 이미지 발송 |
LMS | 국내 LMS 발송 |
ILM | 국제 LMS 발송 |
FSI | 국제 FAX 발송 |
FSD | 국내 FAX 발송 |
VMC | 유선 PHONE 발송 |
VMW | 무선 PHONE 발송 |
WAP | WAP 발송 |
KAT | 알림톡 발송 |
KFT | 친구톡 텍스트 발송 |
KFP | 친구톡 이미지 발송 |
KFW | 친구톡 와이드 이미지 발송 |
RSS | RCS SMS 발송 |
RLS | RCS LMS 발송 |
RMS | RCS MMS 발송 |
RTS | RCS TEMPLATE 발송 |
POLLING 방식
-
Polling 방식을 사용하기 위해서는 별도로 사용 요청이 필요합니다.
-
Polling 방식으로 발송 요청한 메시지들에 대해 일정 시간 후 발송 결과를 확인하는 방식입니다.
-
발송 결과 조회 후 발송 결과 완료 처리를 해야 합니다. 발송 결과 완료 처리를 하지 않으면, 동일한 발송 결과를 응합니다.
-
지정된 기간(3일)동안 발송 결과 조회 혹은 발송 결과 완료 처리를 하지 않으면, 발송 결과 데이터는 제거됩니다.
-
1회 호출 시 최대 1,000개의 발송 결과를 응답합니다.
-
빈번한 발송 결과 요청은 정책에 따라 차단될 수 있습니다.
발송 결과 요청
POST /v1/result/request HTTP/1.1
Content-type: application/json; charset=utf-8
Authorization: Bearer {accesstoken}
Request
설명 | ᆞ발송 결과를 Polling 방식으로 요청하는 기능입니다. |
URL | [POST] api.bizppurio.com/v1/result/request |
Headers
키 | 타입 | 설명 |
Content-type | String | application/json;charset=utf-8 |
Autorization | String | 인증 토 발급을 통에 받은(type) + " " + (accesstoken) |
Body
키 | 타입 | 설명 |
account | String | 비즈뿌리오 계정 |
Response
Headers
키 | 타입 | 설명 |
Content-type | String | application/json;charset=utf-8 |
Body
키 | 필수 | 설명 | ||
code | text | Y | 결과 코드 (1000 : 성공, 이외 실패) | |
description | text | Y | 결과 메시지 | |
report | array | Y | 전송 결과 리스트 | |
device | text | Y | 메시지 유형 | |
cmsgid | text | Y | 메시지 키 | |
msgid | text | Y | 비즈뿌리오 메시지 키 | |
phone | text | Y | 수신 번호 | |
media | text | Y | 실제 발송된 메시지 상세 유형 * MEDIA 유형 | |
to name | text | N | 수신자 명 | |
unixtime | text | Y | 발송 시간 | |
result | text | Y | 이통사/카카오/RCS 결과 코드 * 발송 결과 코드 참조 | |
userdata | text | N | 정산용 부서 코드 | |
wapinfo | text | N | 이통사/카카오 정보 * SKT/KTF/LGT/KAO | |
teires | text | N | 이통사 대체 발송 결과 | |
teltime | text | N | 이통사 대제 발송 시간 | |
kaores | text | N | 카카오 대체 발송 결과 | |
kaotime | text | N | 카카오 대체 발송 시간 | |
resres | text | N | RCS 대체 발송 결과 | |
restime | text | N | RCS 대체 발송 시간 | |
retry_flag | text | N | 대체 발송 정보 | |
resend flag | text | N | 대체 발송 메시지 유형 | |
refkey | text | N | 고객사에서 부여한 키 |
ex)
{
"code": "1000",
"description": "success",
"report": [
{
"device": "SMS",
"cmsgid": "201027134355944sms027420servqer0",
"msgid": "1027se_SL4676027383600490148",
"phone": "01000000000",
"media": "SMS",
"unixtime": "1603773837",
"result": "4100",
"userdata": "daoutech",
"wapinfo": "SKT",
"refkey": "test1234"
},
{
"device": "SMS",
"cmsgid": "201027134355944sms027420servqer0",
"msgid": "1027se_SL4676027383600490148",
"phone": "01000000000",
"media": "SMS",
"unixtime": "1603773837",
"result": "4100",
"userdata": "daoutech",
"wapinfo": "SKT",
"refkey": "test1234"
}
]
}
발송 결과 완료 처리
Request
Headers
POST /v1/result/confirm HTTP/1.1
Content-type: application/json
Authorization: Bearer {인증 토큰 발급을 통해 받은 type + " " + accesstoken}
Body
키 | 타입 | 길이 | 필수 | 설명 | |
account | text | 20 | Y | 비즈뿌리오 계정 | |
msgid | array | 1000 | Y | 메시지 키 배열명 | |
msgid | text | 32 | Y | 메시지 키 |
ex)
{
"account": "test",
"msgid": [
{
"msgid": "1027se_SL4676027383600490148"
},
{
"msgid": "1027se_SL4676027383600490149"
}
]
}
Response
Headers
HTTP/1.1 200 OK
Content-type: application/json
키 | 타입 | 필수 | 설명 |
code | text | Y | 결과 코드 (1000 . 성공, 이외 실패) |
description | text | Y | 결과 메시지 |
ex)
{
"code": 1000,
"description": "Success"
}
댓글
댓글 0개
이 문서에는 댓글을 달 수 없습니다.