# 푸시 알림 보내기 백엔드에서.

> Pocket Alert API로 백엔드에서 푸시 알림을 보내 보세요. Node, Python, PHP, Go에서 인증된 HTTP POST 요청 한 번이면 1초 만에 휴대폰에 도착해요.

<!-- source: https://pocketalert.app/ko/use-cases/api-alerts -->

마지막 업데이트: 2026-08-11

Pocket Alert API는 인증된 HTTP POST 요청 한 번으로 휴대폰에 푸시 알림을 보내요. Node, Python, PHP, Go에서 title, message, 우선순위 level을 담아 호출하면 아이폰이나 안드로이드에 거의 즉시 도착해요.

## 첫 API 푸시 알림까지 3단계

1. **API 키 발급받기** — API 키 페이지에서 API 키를 만들고 환경 변수에 저장해 두세요.
2. **요청 보내기** — Token 헤더에 키를 담아 JSON 형식의 title과 message를 메시지 엔드포인트로 POST 요청하세요.
3. **배포하기** — 1초 안에 휴대폰이 진동해요. 필요에 따라 애플리케이션과 기기 지정을 추가하세요.

## 푸시 알림, 요청 한 번이면 돼요

모든 Pocket Alert 알림은 이 API로 보내요. 요청 한 번으로 백엔드에 연결해 보세요.

- **순수 REST, SDK 불필요** — 이미 쓰고 있는 HTTP 클라이언트에서 인증된 POST 요청 한 번으로 푸시 알림을 보내요. SDK, 큐, 브로커가 필요 없어요.
- **모든 언어 지원** — Node, Python, PHP, Go, Ruby 모두 Pocket Alert 알림을 보낼 수 있어요.
- **키 기반 인증** — API 키는 HTTPS를 통해 Token 헤더로 전달돼요. 키 생성, 범위 지정, 교체를 원하는 일정에 맞춰 직접 관리하세요.
- **세밀한 제어** — application_id로 라우팅하고 device_id로 기기 하나를 지정하거나, 생략해서 모든 기기에 한 번의 요청으로 보낼 수 있어요.
- **1초 미만 전달** — 푸시 알림이 아이폰이나 안드로이드에 1초 미만으로 도착해요. 실시간 백엔드 알림을 구현하기에 충분히 빨라요.
- **CLI 및 웹훅 연동 지원** — 같은 API가 CLI와 웹훅도 지원해요. 코드로 시작하고 나중에 둘 중 하나를 추가하면 돼요.

## 첫 API 푸시 알림 보내기

### 1. API 키 발급받기

[API 키](https://pocketalert.app/ko/account/apikeys) 페이지에서 키를 만든 뒤, 모든 요청의 `Token` 헤더에 담아 보내세요.

### 2. 메시지 POST 요청하기

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. 코드에서 호출하기

엔드포인트에 오류가 나거나 사용자 정의 이벤트가 발생할 때 호출해 보세요. 예를 들어 상태 확인이 실패했거나 새 주문이 들어왔을 때요:

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

애플리케이션과 기기 지정 방법은 [시작 가이드 문서](https://info.pocketalert.app/getting-started.html)에서 자세히 확인할 수 있어요.

## 자주 묻는 질문

### API로 푸시 알림은 어떻게 보내나요?

Token 헤더에 키를, 본문에 title과 message를 담은 JSON으로 Pocket Alert 메시지 API에 POST 요청을 보내세요. 알림은 바로 휴대폰에 도착해요.

### API 인증은 어떻게 작동하나요?

설정 페이지에서 발급받은 API 키를 HTTPS로 Token 헤더에 담아 인증해요. 필요할 때마다 키를 만들거나 교체할 수 있고, 애플리케이션별로 알림 범위를 지정할 수도 있어요.

### 어떤 언어를 지원하나요?

HTTP 요청을 보낼 수 있는 언어라면 모두 사용할 수 있어요. Node, Python, PHP, Go, Ruby, Rust 등이 해당해요. 따로 설치할 것 없이 이미 쓰고 있는 HTTP 클라이언트로 일반 REST 호출만 하면 돼요.

### 요청에서 무엇을 제어할 수 있나요?

title과 message를 설정하고, application_id로 특정 애플리케이션을 지정하고, device_id로 기기 하나를 대상으로 하거나 생략해서 모든 기기에 보낼 수 있어요. level로 무음부터 긴급까지 우선순위도 정할 수 있어요. 긴급 알림은 안드로이드에서 방해 금지 모드를 무시하고, 아이폰에서는 집중 모드를 뚫고 도착해요.

### CLI나 웹훅 옵션도 있나요?

네, 있어요. Pocket Alert CLI가 같은 API를 스크립트와 CI에서 쓸 수 있도록 감싸 줘요. 코드를 쓰고 싶지 않다면 웹훅을 만들어 서비스의 수신 URL에 연결하면 돼요.
