# API 설정

## 1. API 키 조회

API 키는 [<mark style="color:orange;">\[Client Admin\]</mark>](https://client-admin.bleepy.io/) 내 <mark style="color:blue;">`[관리자 메뉴]`</mark> > <mark style="color:blue;">`[API 사용 관리]`</mark> 페이지에서 조회와 재발급을 할 수 있습니다.

클라이언트 서버에서 블리피 서버로 요청을 보낼 때는 인증을 위하여 발급된 API 키를 <mark style="color:blue;">`Header`</mark> 내 <mark style="color:blue;">`API-Key`</mark>`값으로 전달해야합니다.`&#x20;

<figure><img src="/files/rkowUNEFgXKnhbWxwYoS" alt=""><figcaption></figcaption></figure>

➀ 발급된 API 키 정보를 표시합니다. 보안을 위해 앞 3자리만 표시됩니다.

➁ API 키 확인하기 버튼을 클릭하면 API 키의 전체 정보를 확인할 수 있습니다.

➂ 새로운 API 키를 발급 받을 수 있습니다. 재발급을 진행할 경우 기존의 API 키는 블리피 서버 내에서 삭제되므로 꼭 요청 <mark style="color:blue;">`Header`</mark> 내 <mark style="color:blue;">`API-Key`</mark> 정보를 재 발급된 정보로 변경해 주세요.&#x20;

***

## 2. 고정 IP 정보 등록

클라이언트 측 서버에서 블리피 서버에 요청을 보내려면 자사 서버의 고정 IP 정보가 필요합니다.\
블리피는 보안 사고를 대비해 등록된 IP 정보로 들어오는 요청만 허용하고 있습니다.&#x20;

<figure><img src="/files/R1gWjdD61zkMqvoZbAUG" alt=""><figcaption></figcaption></figure>

➀ IP 주소 등록 버튼을 클릭하면 IP 주소 등록 팝업이 호출되어 정보를 입력할 수 있습니다.

➁ IP 주소 리스트에서 등록된 IP 주소를 조회하고 삭제할 수 있습니다.

***

## 3. API 주소 등록하기

블리피에서 제공하는 자동 전송 기능을 사용하기 위한 API를 등록할 수 있습니다.

<figure><img src="/files/pE8WLX6EduZ2t5YS0hDF" alt=""><figcaption></figcaption></figure>

➀ 유저에게 기프트/리워드를 자동 지급하기 위해, <mark style="color:blue;">`[자동 지급 API 주소]`</mark>를 등록할 수 있습니다.

* 자동 지급 API 등록 시, 기프트 또는 리워드 달성 시점에 지급 대상자 정보가 콜백됩니다.
* 이 때 지급 항목 데이터의 상태 처리도 자동으로 진행됩니다.

➁  PUSH 자동 발송 시점에 대상 유저 데이터를 수신하기 위해, <mark style="color:blue;">`[PUSH 발송 API 주소]`</mark>를 등록할 수 있습니다.

* 육성게임의 경우 오전 10시/오후 2시 총 2번에 걸쳐 PUSH 자동 발송 대상자 정보가 콜백됩니다.

{% 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/setting.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.