개발자 API

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

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

<1초 내 푸시 전달간단한 RESTNode · Python · Go · PHP 업데이트
기능

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

모든 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 푸시 알림까지 3단계

1

API 키 발급받기

API 키 페이지에서 API 키를 만들고 환경 변수에 저장해 두세요.

2

요청 보내기

Token 헤더에 키를 담아 JSON 형식의 title과 message를 메시지 엔드포인트로 POST 요청하세요.

3

배포하기

1초 안에 휴대폰이 진동해요. 필요에 따라 애플리케이션과 기기 지정을 추가하세요.

첫 API 푸시 알림 보내기

1. API 키 발급받기

API 키 페이지에서 키를 만든 뒤, 모든 요청의 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",
  }),
});

애플리케이션과 기기 지정 방법은 시작 가이드 문서에서 자세히 확인할 수 있어요.

FAQ

궁금한 점을 답해드려요

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

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

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

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

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

요청 한 번이면 휴대폰까지 바로 도착해요.

API 키를 만들고 백엔드에서 첫 푸시 알림을 보내 보세요.