비즈뿌리오 API 소개

본 문서는 비즈뿌리오 서비스의 기능을 HTTP 요청으로 활용할 수 있는 API에 대한 명세와 예제코드를 담은 문서입니다.

선결 조건

API를 사용하여 메시지 발송을 하기 위해서 아래의 조건이 선결되어야 합니다.

1. 서비스 계정 생성 및 사용 승인 - 비즈뿌리오 (https://www.bizppurio.com) 에서 API 용도로 계정 생성

운영과 검수 용도로 계정을 구분하여 생성

2. 전송 결과 수신 정보 등록 - 리포트 수신이 필요한 경우, 수신 받을 URL (IP/PORT)에 대한 정보 등록 요청

443,80을 제외한 포트를 사용해야 하는 경우, 별도로 방화벽 접근에 대한 허용 요청

카카오톡 비즈메시지 사용하는 경우

1) 카카오톡 채널 개설 및 비즈니스 채널 신청 (https://center-pf.kakao.com)

2) 발신 프로필 키 생성 (https://www.bizppurio.com)

3) 알림톡 템플릿 등록/승인 및 친구톡 이미지 등록 (https://www.bizppurio.com)

API로 카카오톡 비즈메시지 템플릿을 생성하려면 <>을 참고하십시오

RCS 사용하는 경우

1) RCS 브랜드 개설 및 대행사 설정 (https://www.rcsbizcenter.com)

2) RCS 브랜드 등록

2) RCS 브랜드 등록 (https://www.bizppurio.com)

3) RCS 발신번호 및 템플릿 등록/승인 (https://www.bizppurio.com)

연동 규격

1. HTTPS

API를 위한 모든 HTTP 요청의 경우 SSL 환경의 HTTPS (443) 를 이용합니다.

2. UTF-8

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

API 도메인

운영 : api.bizppurio.com

검수 : dev-api.bizppurio.com

API 기능

인증 토큰 발급

설명

  • API 서비스를 이용하기 위해서 인증 토큰을 발급하기 위한 기능입니다.

  • 인증 토큰의 유효 시간은 24시간이며, 이후에는 재발급이 필요합니다.

  • Authorization 헤더에 비즈뿌리오 계정과 암호를 Base64 인코딩한 문자열을 입력합니다.

URL

[POST] api.bizppurio.com/v1/token 세부스펙

메시지 발송

설명

  • 메시지 발송을 요청하는 기능입니다.

URL

[POST] api.bizppurio.com/v3/message 세부스펙

File Upload

설명

  • 파일을 업로드 하여 MMS 전송 시 사용할 파일 키를 발급합니다.

  • 파일은 확장자(jpg/jpeg), 크기(300kbyte 이하) 제한이 있습니다.

  • 요청 시 파일 업로드 수는 1개로 제한합니다.

URL

[POST] api.bizppurio.com/v1/file 세부스펙

전송 결과

설명

  • 발송 결과를 재요청하는 기능입니다.

URL

api.bizppurio.com/v2/report 세부스펙

발송 결과 요청 (POLLING 방식)

설명

  • 발송 결과를 요청하는 기능입니다. (POLLING 방식)

URL

api.bizppurio.com/v1/result/request 세부스펙

발송 결과 완료 처리 (POLLING 방식)

설명

  • 발송 결과 요청을 완료하는 기능입니다. (POLLING 방식, 발송 결과 요청 후 완료 필요)

URL

api.bizppurio.com/v1/confirm 세부스펙

Last updated