REST API - 직관적이고 보안이 강화된 Rest API를 통해 여러분의 서비스에 최적화된 메시지 시스템을 설계해 보세요.

기술정보센터

REST API

- 인포뱅크에서 제공하는 HTTPS방식을 이용해 RCS메시지를 전송하는 REST API입니다.
  본 규격을 이용하여 국내 RCS메시징 서비스를 이용할 수 있습니다.
- 본 서비스를 이용하기 위해서 영업 담당자로부터 접속 정보를 제공받아야 합니다.

REST API 신청하기
사전 준비사항

접속 계정
영업 담당자로부터 RCS REST-API 접속 계정 정보를 제공받아야 합니다.

RCS Biz Center 가입 및 정보 등록
- RCS 발송을 위해 RCS Biz Center 사이트(https://www.rcsbizcenter.com)에 접속하여 가입한 후, 기업, Brand정보, 발신번호, 대행사(인포뱅크) 등의 정보를 등록해야 합니다.
- 가입 시 영업 담당자에 문의하여 주시기 바랍니다.
- RCS 템플릿 발송을 위해서는 템플릿 등록 요청 후 승인이 필요합니다.

네트워크 방화벽 허용
- 인포뱅크 RCS REST-API 서버 에 대해 방화벽 허용(Outbound)이 필요합니다.
- 인포뱅크 G/W는 Any로 열려 있습니다.

전문 규격

HTTPS METHOD
전송 요청을 위해 HTTPS GET/POST 방식을 제공하며 전송 응답은 JSON 방식을 사용합니다.

ENCODING
UTF-8 인코딩을 기본으로 제공합니다.

TIMEZONE
본 API에 대한 기준 시간은 한국 표준 시 KST(UTC+9)를 사용합니다.

API 리스트

API 설명

인증(토큰 발급) API
- 서비스 이용 시 인증에 사용할 토큰을 발급 받기 위한 API입니다.
- 발급 시 만료 시간이 있으며 만료 시간(24시간) 후에는 사용이 불가하고 재발급이 필요합니다.
- 토큰이 외부로 노출될 경우 악용의 소지가 있으므로 유의 바랍니다.

파일 업로드 API
- RCS MMS발송에 사용될 이미지 파일 업로드 API입니다.
- 파일 업로드 후 발급되는 파일 키 값을 사용 합니다.
- 파일 키 발급 시 만료 시간이 있으며 만료 시간 후에는 파일이 삭제됩니다.

메시지 전송 API
- 메시지 발송을 요청하는 API입니다.

리포트 API
- 메시지 전송 결과를 확인할 수 있는 API입니다.

* 리포트를 수신 하기 위해서는 인포뱅크에서 제공하는 서버 IP에 대한 접근을 허용해야 합니다.
  결과 송신 서버 IP 정보 : 211.115.98.168, 211.115.98.169

API URL 정보

API URL
인증(토큰 발급) API https://rcs-auth.ibizplus.co.kr:7000/v1/auth/token
파일 업로드 API https://rcs-file.ibizplus.co.kr:7010/v1/rcs/file
메시지 전송 API https://rcs-msg.ibizplus.co.kr:7020/v1/rcs/destination
리포트 API (PUSH) 인포뱅크에 등록한 URL 정보

API에 대한 자세한 내용은 메뉴얼을 다운로드 받아 확인해 주세요.

참고사항

RCS 메시지 종류

RCS SMS (Rich Communication Services Short Message Service)
- 100자 이하, 최대 버튼 1개의 RCS메시지를 전송하는 서비스

RCS LMS (Rich Communication Services Long Message Service)
- 1,300자 이하, 최대 버튼 3개의 RCS메시지를 전송하는 서비스

RCS MMS (Rich Communication Services Multimedia Message Service)
- 1,300자 이하, 최대 버튼 2개, 이미지가 포함된 RCS메시지를 전송하는 서비스

RCS MMS (Carousel)
- 1,300자 이하, 최대 카드 6개, 카드 별 최대 버튼 2개의 다중 카드의 RCS 메시지를 전송 하는 서비스

RCS 템플릿(Template)
- 90자 이하, 사전 등록된 지정된 형태의 RCS 메시지를 전송하는 서비스
- Free 템플릿: RCS Biz Center를 통한 계정 생성 시 바로 사용 가능한 템플릿
- Description 템플릿: 등록된 형태에 맞게 전체 메시지내용을 기술하여 요청하는 템플릿
- Cell 템플릿: 등록된 블럭 구조에 맞게 key, value를 JSON형태로 요청하는 템플릿

FAILOVER

- RCS 발송 요청 시 FAILOVER 메시지 설정을 할 수 있습니다.
- RCS 발송이 실패 할 경우 지정된 FAILOVER 메시지 데이터로 인포뱅크 G/W에서 발송 시도합니다.
- RCS 발송이 성공 한 경우 FAILOVER 메시지는 발송 되지 않습니다.
- FAILOVER 설정 상관 없이 발송 결과(REPORT)는 발송 요청 1건당 결과 1건이 전달됩니다.
- FAILOVER 처리 여부는 발송 결과(REPORT)로 전달된 CARRIER(이통사코드) 값으로 구별하여 확인 할 수 있습니다. (최종 이통사코드 값이 FAILOVER일 경우는 RCS실패 후 FAILOVER 발송 처리)

Download

기술지원 상담

iMessage 서버개발팀

Email support@infobank.net

Back to top
  • 상담요청하기
  • CONTACT US
  • FAQ
  • 상담 게시판