> For the complete documentation index, see [llms.txt](https://bleepy.gitbook.io/bleepy-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bleepy.gitbook.io/bleepy-developers/api/push-notification.md).

# PUSH 발송 API

육성게임 프로모션에서 자동 발송 시점에 PUSH 데이터를 받을 수 있는 API 문서입니다. \
블리피로부터 전달 받은 유저키 데이터를 활용하여 유저들에게 PUSH를 발송해보세요.

<mark style="color:blue;">`[PUSH 발송 API 주소]`</mark> 등록 시, 자동 발송 케이스에 해당하는 유저 데이터를 정해진 시간에 전달 받을 수 있습니다.\
등록 방법은 [API 설정](/bleepy-developers/api/setting.md) 페이지를 참고하세요.

{% hint style="info" %}
PUSH 전송을 원하지 않으시는 경우, PUSH 전송 사용을 중지 하시거나 등록 된 \[PUSH 발송 API] 주소를 삭제 해주세요.&#x20;

* [<mark style="color:orange;">\[Client Admin\]</mark>](https://client-admin.bleepy.io/) 로그인 > 프로모션 관리 > PUSH 관리 > 자동 발송 탭 내 사용여부 ON/OFF
  {% endhint %}

***

{% hint style="info" %} <mark style="color:yellow;">해당 API는 블리피 서버 -> 클라이언트 서버로 요청됩니다.</mark>
{% endhint %}

## Request

<table><thead><tr><th width="154">Method</th><th>URL</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>POST</code></mark></td><td>API 사용 관리 페이지에 등록한 클라이언트별 <mark style="color:blue;">[PUSH 발송 API]</mark> 주소</td></tr></tbody></table>

### 본문

```json
// Body Example
{
  code: "AD3FYTFS",
  userKeyList: [
    "2eew35da"
  ]
}
```

<table><thead><tr><th width="178">Name</th><th width="194">Type</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>code</code></mark></td><td>string</td><td>PUSH 발송에서 설정된 PUSH 연동 코드</td></tr><tr><td><mark style="color:orange;"><code>userKeyList</code></mark></td><td>ArrayList[String]</td><td>PUSH 발송 대상인 userKey 정보</td></tr></tbody></table>

### 연동 코드 정보

<table><thead><tr><th width="242">연동 code</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>%PUSH 연동 코드%</code></mark></td><td>PUSH 자동 발송 케이스별 연동 코드는 <a href="https://client-admin.bleepy.io/"><mark style="color:orange;">[Client Admin]</mark></a> > 프로모션 관리 > PUSH 관리 > 자동발송 탭에서 확인할 수 있습니다.</td></tr></tbody></table>

***

## Response

### 요청 처리 정상

| HTTP status code                        |
| --------------------------------------- |
| <mark style="color:green;">`200`</mark> |

{% hint style="info" %}
참고

PUSH 발송 콜백 전달 시, userKeyList는 Max 50개씩 전달됩니다.

(ex. 70건 PUSH 데이터 전송 시, 50건 / 20건으로 2번에 걸쳐 전송)
{% endhint %}

{% hint style="info" %}
개발에 대한 추가 설명이 더 필요하신가요?

"[<mark style="color:orange;">\[Client Admin\]</mark>](https://client-admin.bleepy.io/login) 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.
{% endhint %}
