# 비즈뿌리오 API 소개

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

### 선결 조건

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

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

{% embed url="<https://www.bizppurio.com>" %}

{% hint style="warning" %}
&#x20;운영과 검수 용도로 계정을 구분하여 생성
{% endhint %}

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

{% hint style="warning" %}
443,80을 제외한 포트를 사용해야 하는 경우, 별도로 방화벽 접근에 대한 허용 요청
{% endhint %}

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

&#x20;   1\) 카카오톡 채널 개설 및 비즈니스 채널 신청 (<https://center-pf.kakao.com>)

{% embed url="<https://center-pf.kakao.com>" %}

&#x20;   2\) 발신 프로필 키 생성 (<https://www.bizppurio.com>)

&#x20;    3\) 알림톡 템플릿 등록/승인 및 친구톡 이미지 등록 (<https://www.bizppurio.com>)

{% hint style="info" %}
API로 카카오톡 비즈메시지 템플릿을 생성하려면 <>을 참고하십시오
{% endhint %}

### RCS **사용하는 경우**

&#x20;   1\) RCS 브랜드 개설 및 대행사 설정 (<https://www.rcsbizcenter.com>)

{% embed url="<https://www.rcsbizcenter.com>" %}
2\) RCS 브랜드 등록
{% endembed %}

&#x20;   2\) RCS 브랜드 등록 (<https://www.bizppurio.com>)

&#x20;   3\) RCS 발신번호 및 템플릿 등록/승인 (<https://www.bizppurio.com>)

{% embed url="<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 기능**

**인증 토큰 발급**

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="593.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>API 서비스를 이용하기 위해서 인증 토큰을 발급하기 위한 기능입니다.</li><li>인증 토큰의 유효 시간은 24시간이며, 이후에는 재발급이 필요합니다.</li><li>Authorization 헤더에 비즈뿌리오 계정과 암호를 Base64 인코딩한 문자열을 입력합니다.</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>[POST]</strong> <strong>api.bizppurio.com/v1/token</strong><br><a href="/pages/L4SrSwyWoz31oISQqV04"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>

**메시지 발송**

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="555.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>메시지 발송을 요청하는 기능입니다.</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>[POST] api.bizppurio.com/v3/message</strong><br><a href="/pages/QCfWu0olWOEyFiRvKZL0"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>

**File Upload**

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="570.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>파일을 업로드 하여 MMS 전송 시 사용할 파일 키를 발급합니다.</li><li>파일은 확장자(jpg/jpeg), 크기(300kbyte 이하) 제한이 있습니다.</li><li>요청 시 파일 업로드 수는 1개로 제한합니다.</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>[POST] api.bizppurio.com/v1/file</strong><br><a href="/pages/X7HQv1KJEhUtrkuuT8Az"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>

**전송 결과**

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="570.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>발송 결과를 재요청하는 기능입니다.</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>api.bizppurio.com/v2/report</strong><br><a href="/pages/pWihMYoYsoLK6kkosi0g"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>

**발송 결과 요청 (POLLING 방식)**

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="570.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>발송 결과를 요청하는 기능입니다. (POLLING 방식)</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>api.bizppurio.com/v1/result/request</strong><br><a href="/pages/OHgWZWqgmF4Gt4n6dJ5D#undefined"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>

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

<table data-header-hidden><thead><tr><th width="150" align="center"></th><th width="570.3333333333333"></th></tr></thead><tbody><tr><td align="center"><strong>설명</strong> </td><td><ul><li>발송 결과 요청을 완료하는 기능입니다. <br>(POLLING 방식, 발송 결과 요청 후 완료 필요)</li></ul></td></tr><tr><td align="center"><strong>URL</strong></td><td><strong>api.bizppurio.com/v1/confirm</strong><br><a href="/pages/OHgWZWqgmF4Gt4n6dJ5D#undefined-1"><strong><code>세부스펙</code></strong></a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://biztech.gitbook.io/webapi/intro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.