# 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 %}


---

# 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://bleepy.gitbook.io/bleepy-developers/api/push-notification.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.