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

> curl 명령어 한 줄로 휴대폰에 푸시 알림을 보내세요. 터미널, bash 스크립트, 크론 작업 어디서든 Pocket Alert API로 POST만 하면 돼요. SDK 없이 쓸 수 있고 무료 플랜도 있어요.

<!-- source: https://pocketalert.app/ko/use-cases/curl-push-notifications -->

마지막 업데이트: 2026-10-25

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

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

1. **API 키 발급받기** — 무료로 회원가입한 뒤 API 키 페이지에서 키를 만들고, 환경 변수로 내보내세요.
2. **API에 curl 보내기** — Token 헤더와 함께 /v1/messages에 title과 message를 POST하세요. form-data든 JSON이든 괜찮아요.
3. **휴대폰이 울려요** — 푸시 알림이 1초 안에 도착해요. &&나 ||로 연결하면 성공 또는 실패 시에 알림을 받을 수 있어요.

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

이미 터미널을 주로 쓰고 계시잖아요. 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. 한 줄 명령

```
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 키](https://pocketalert.app/ko/account/apikeys) 페이지에서 키를 만들어 주세요. 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](https://pocketalert.app/ko/tools/cli)가 같은 API를 감싸 제공해요. 일반 HTTP 요청이라서 Python, Go, PowerShell, 또는 [크론 작업](https://pocketalert.app/ko/use-cases/cron-job-alerts)에서도 똑같은 호출을 그대로 쓸 수 있어요.

## 자주 묻는 질문

### 푸시 알림을 보내는 가장 간단한 curl 명령은 무엇인가요?

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

### API는 JSON을 받나요, 아니면 폼 필드를 받나요?

둘 다 가능해요. 엔드포인트는 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 키는 어디에서 얻나요?

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