명령줄

내 휴대폰, curl 한 줄이면 닿아요.

curl 명령 한 줄로 휴대폰에 푸시 알림을 보내세요. API 키와 함께 title과 message를 Pocket Alert API에 POST하면, 1초 안에 iPhone이나 Android에 도착해요. curl이 설치된 셸, 스크립트, 기기라면 어디서든 동작해요.

curl만 있으면 돼요JSON 또는 form-data무료: 하루 50건 업데이트
기능

터미널에서 휴대폰까지 이어지는 흐름

이미 터미널을 주로 쓰고 계시잖아요. Pocket Alert는 휴대폰을 curl 한 줄 거리에 두어요. SDK도, 데몬도, 직접 운영할 알림 서버도 필요 없어요.

한 줄이면 충분해요, SDK 없이

API 키를 담은 Token 헤더와 함께 title과 message를 POST하세요. SDK도, OAuth도, curl 외에 필요한 의존성도 없어요.

셸 스크립트를 위해 만들었어요

&&와 ||로 연결해서 성공, 실패, 또는 둘 다일 때 푸시 알림을 보낼 수 있어요. crontab과 CI 스크립트에 익숙한 방식이에요.

JSON 또는 폼 필드

JSON이든 form-data든 괜찮아요. API가 콘텐츠 타입을 자동으로 감지하므로, 간단한 터미널 명령과 스크립트 방식 모두 동작해요.

메시지별 우선순위

실제 장애 상황에는 level=critical을 추가해 무음 모드를 뚫고, 진동 없이 기록만 남기려면 level=silent를 사용하세요.

기록 기능 포함

모든 푸시 알림은 전달 통계와 함께 기록에 남아요. 보내고 잊어버린 스크립트 메시지도 실제로 사라지지 않아요.

어떤 기기에서든 동작해요

Raspberry Pi, 빌드 서버, VPS, WSL 어디에서든 같은 요청으로 보낼 수 있어요. curl이 실행되는 곳이라면 휴대폰에 알림을 보낼 수 있어요.

시작하기

셸에서 주머니까지, 세 단계면 충분해요

1

API 키 발급받기

무료로 회원가입한 뒤 API 키 페이지에서 키를 만들고, 환경 변수로 내보내세요.

2

API에 curl 보내기

Token 헤더와 함께 /v1/messages에 title과 message를 POST하세요. form-data든 JSON이든 괜찮아요.

3

휴대폰이 울려요

푸시 알림이 1초 안에 도착해요. &&나 ||로 연결하면 성공 또는 실패 시에 알림을 받을 수 있어요.

터미널에서 푸시 알림 보내기

1. 한 줄 명령

curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Deploy finished' -F 'message=v2.4.1 is live on production'

API 키 페이지에서 키를 만들어 주세요. JSON을 선호하신다면 이렇게 보내도 돼요:

curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Deploy finished","message":"v2.4.1 is live on production"}'

2. 어떤 명령과도 연결하기

오래 걸리는 작업이 끝났을 때, 또는 실패했을 때만 알림을 받아 보세요:

# push when the build succeeds
make release && curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' -F 'title=Build OK' -F 'message=make release finished'

# push only on failure, and make it loud
./migrate.sh || curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Migration FAILED' -F 'message=migrate.sh exited non-zero' -F 'level=critical'

3. 함수로 감싸기

.bashrc 또는 .zshrc에 아래 코드를 넣어 두면 URL을 다시 입력할 필요가 없어요:

notify() {
  curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
    -H "Token: $POCKETALERT_KEY" \
    --form-string "title=$1" --form-string "message=$2" --form-string "level=${3:-default}" > /dev/null
}

# usage
long_task; notify "long_task done" "exit code $?"
notify "Disk warning" "/dev/sda1 at 91%" high

실행 파일을 직접 쓰고 싶다면 Pocket Alert CLI가 같은 API를 감싸 제공해요. 일반 HTTP 요청이라서 Python, Go, PowerShell, 또는 크론 작업에서도 똑같은 호출을 그대로 쓸 수 있어요.

FAQ

궁금한 점을 답해드려요

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. 이게 전부예요. SDK도, 클라이언트 라이브러리도, OAuth 절차도 필요 없어요. curl이 설치된 기기라면 어디서든 보낼 수 있어요.

둘 다 가능해요. 엔드포인트는 application/json과 form-data(-d key=value 쌍) 모두 받아들이고, 보낸 형식을 자동으로 감지해요. 터미널에서는 form-data가 입력하기 짧고, 프로그램으로 만들 때는 JSON이 더 편해요.

명령 뒤에 &&를 붙이면 make build && curl … 은 성공했을 때만 실행돼요. 실패 알림에는 ||를 쓰고, 성공 여부와 관계없이 알리려면 ;를 사용하세요. 오래 걸리는 작업이라면 종료 코드를 저장해서 메시지에 넣으면, 푸시 알림으로 결과를 바로 확인할 수 있어요.

-F 'level=critical'을 추가하면 Android에서는 방해 금지 모드를, iPhone에서는 집중 모드를 뚫고 알림이 전달돼요. 소리 없이 기록만 남기고 싶다면 level=silent를 사용하세요. 우선순위는 silent, low, default, high, critical 다섯 단계예요.

회원가입한 뒤 API 키 페이지에서 만들 수 있어요. 스크립트에 직접 하드코딩하지 말고 환경 변수나 비밀 값 관리 도구에 저장하세요. 무료 플랜에서는 하루 50건의 메시지를 보낼 수 있어요. 바쁜 날 스크립트 알림을 보내기에 충분한 양이에요.

터미널이 주머니 속 휴대폰을 울릴 수 있어요.

API 키 하나와 curl 한 줄이면, 여러분이 쓰는 모든 터미널에서 휴대폰으로 알림을 보낼 수 있어요.