웹훅으로 연동하기 — ntfy 호환·AI 질문
채널마다 웹훅 URL을 발급합니다. 이 URL로 무엇이든 보내면 이오스 알림으로 발송됩니다. API 키도 코드도 필요 없습니다. 웹훅은 콘솔 채널 설정이나 맥·윈도우 매니저 앱의 채널 설정에서 만듭니다.
웹훅 만들기
웹훅마다 수신 대상을 지정합니다. 「나」(이 채널을 구독한 내 기기), 「선택한 구독자」(최대 50명), 「전체 구독자」 중 하나입니다. 요청으로는 수신 대상을 변경할 수 없습니다. URL이 유출되면 채널 설정에서 바로 재발급하십시오. 기존 URL은 그 즉시 사용할 수 없게 됩니다.
알림 보내기
본문만 보내면 됩니다. 제목·중요도·링크는 쿼리 파라미터나 헤더로 지정합니다.
curl -d "서버 디스크 사용량 90%" https://api.eosnoti.com/h/<웹훅 토큰>
curl -d "배포가 끝났습니다" "https://api.eosnoti.com/h/<웹훅 토큰>?title=배포&priority=high"
curl -H "Content-Type: application/json" \
-d '{"title":"백업","message":"오늘 백업에 실패했습니다","url":"https://example.com/logs"}' \
https://api.eosnoti.com/h/<웹훅 토큰>요청 형식
JSON이면 제목은 title, 본문은 body → message → text(슬랙식) → content(디스코드식) → msg(Uptime Kuma) 순서로 처음 있는 값을 씁니다. 아는 칸이 없으면 JSON 원문을 그대로 본문으로 보냅니다. 링크는 url 또는 click, 중요도는 priority(normal·high, 또는 ntfy식 1~5·urgent)입니다. JSON이 아니면 본문 전체가 알림 본문입니다. 쿼리(?title=·?priority=·?url=)가 있으면 위 값을 덮습니다.
묻고 답 받기 (AI·스크립트)
choices를 지정하면 선택형 질문이 됩니다. 폰·PC 이오스 앱에 버튼이 표시되고, 누른 응답이 요청한 쪽으로 반환됩니다. 수신자가 여럿인 웹훅이면 가장 먼저 누른 응답 하나로 확정됩니다. 질문에는 만료가 없습니다 — 응답이 올 때까지 기다리십시오.
요청 한 번은 최대 25초 대기합니다. 그 안에 응답이 오면 200과 응답을, 아니면 202와 다시 대기할 URL을 반환합니다(JSON이면 wait_url, 항상 Location 헤더에도). format=text를 지정하면 응답 텍스트만 반환해 셸에서 쓰기 쉽습니다. 이때 오류는 본문 없이 상태 코드만 반환되므로, 200·202가 아니면 응답으로 읽지 말고 중단하십시오.
#!/usr/bin/env bash
# 묻고, 답이 올 때까지 기다렸다가, 답 글자를 받는다.
# ⚠️200(답)·202(아직)만 정상이다. 그 밖의 코드는 답이 아니다 — 진행하지 말고 멈춘다.
HOOK="https://api.eosnoti.com/h/<웹훅 토큰>"
hdr=$(mktemp)
code=$(curl -s -o /dev/null -D "$hdr" -w '%{http_code}' \
-d "배포를 진행할까요?" "$HOOK?choices=진행,중단&format=text")
[ "$code" = 202 ] || { echo "질문을 보내지 못했습니다($code)"; exit 1; }
url=$(grep -i '^location:' "$hdr" | tr -d '\r' | cut -d' ' -f2)
while :; do
answer=$(curl -s -w '\n%{http_code}' "$url?wait=25&format=text")
code=$(echo "$answer" | tail -n1); answer=$(echo "$answer" | sed '$d')
[ "$code" = 200 ] && break
[ "$code" = 202 ] || { echo "답을 받지 못했습니다($code)"; exit 1; }
done
echo "답: $answer" # 진행 또는 중단{"status":"answered","answer":"진행","answered_by":"홍길동"} · 202 {"status":"waiting","wait_url":"…"} · 409 no_recipientsntfy를 지원하는 도구
ntfy 알림을 지원하는 도구는 설정만 바꾸면 됩니다. 서버 URL 칸에 https://api.eosnoti.com/ntfy, 토픽 칸에 웹훅 토큰(URL 끝부분)을 입력하십시오. 접근 토큰 칸이 있으면 같은 토큰을 입력해도 됩니다. ntfy 경로로는 질문을 보낼 수 없습니다.
curl -H "Title: NAS" -H "Priority: 5" -d "백업 실패" https://api.eosnoti.com/ntfy/<웹훅 토큰>연동 예시
GitHub Actions·크론 작업·iOS 단축어(「URL 내용 가져오기」, 방법 POST)에서 웹훅 URL로 보내면 됩니다.
# GitHub Actions — 실패했을 때만
- if: failure()
run: curl -d "${{ github.workflow }} 실패" "${{ secrets.EOS_HOOK }}?priority=high"
# Claude Code 훅(settings.json의 Stop 훅) — 작업이 끝나면
curl -s -d "Claude Code 작업이 끝났습니다" "$EOS_HOOK" > /dev/null한도와 요금
웹훅 하나당 1분에 30건, 1시간에 300건까지 수신합니다. 초과하면 429를 반환하고 채널 소유자에게 한 번 알립니다. 수신자가 없으면(예: 「나」인데 내 기기가 이 채널을 구독하지 않음) 409 no_recipients로 즉시 실패합니다. 발송한 알림은 요금제 발송 건수(기기 한 대에 한 번 = 1건)에 포함됩니다.