Hookablehookable.
API REFERENCE

Hookable API 문서

Push URL로 HTTP 요청을 보내면 내 폰에 푸시 알림이 갑니다. 앱의 My 탭에서 Push URL(수신 ID rcp_…)과 발신 API 키(hk_…)를 복사해 쓰세요.

시작하기

모든 요청에 Authorization: Bearer hk_… 헤더가 필요합니다. API 키는 계정 단위이고, Push URL은 기기마다 다릅니다. 둘 다 앱에서 재발급할 수 있습니다.

GET | POST  https://api.hookable.cc/functions/v1/push/{recipient_id}

GET으로 보내기

가장 짧은 방법입니다. 한글·특수문자는 curl의 --data-urlencode로 보내면 인코딩 걱정이 없습니다.

curl -G "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  --data-urlencode "title=배포 완료" \
  --data-urlencode "body=main 성공 (2분 13초)"

POST JSON으로 보내기

제목·본문 외에 data(임의 JSON, 4KB)를 함께 보낼 수 있습니다. data는 히스토리 상세에 그대로 표시되고, data.url은 알림을 탭할 때 여는 링크가 됩니다.

curl -X POST "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"배포 완료","body":"main 성공 (2분 13초)","data":{"url":"https://ci.example.com/build/123"}}'

url을 넣으면 알림을 탭하는 순간 그 링크가 열립니다. 웹 주소(https)는 브라우저나 유니버설 링크·앱 링크로 연결된 앱이 열고, myapp:// 같은 커스텀 스킴은 해당 앱이 열립니다. 스킴이 없거나 javascript:·file:·intent: 같은 위험한 스킴이면 링크 없이 알림만 보냅니다. 한글·공백이 섞인 주소는 서버가 알아서 인코딩합니다. GET으로 보낼 때는 url 안의 &·#·+가 깨지지 않도록 --data-urlencode를 쓰세요.

curl -X POST "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"배포 완료","url":"https://github.com/me/app/actions/runs/123"}'

# 앱 딥링크
curl -G "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  --data-urlencode "title=배포 완료" \
  --data-urlencode "url=myapp://orders/1042"

이미지 첨부

image에 https 이미지 주소를 넣으면 알림에 사진이 붙고 히스토리 상세에도 보입니다. JPEG·PNG·GIF(iOS는 HEIC도), 10MB 이하가 가장 확실합니다. 이미지는 Hookable 서버에 저장되지 않고 폰이 직접 내려받으며, 받지 못하면 텍스트만 보여 줍니다.

curl -X POST "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"배포 완료","image":"https://example.com/chart.png"}'

브라우저에서 보내기

발송 API는 CORS를 허용하므로 웹페이지의 JavaScript에서 바로 호출할 수 있습니다. 직접 해 보려면 「웹에서 보내기」 페이지를 쓰세요. 단, API 키가 들어간 코드를 공개 웹사이트에 올리면 누구나 키를 볼 수 있으니 내 PC의 도구·사내 대시보드처럼 나만 쓰는 곳에서만 쓰세요. 웹에서 보내기 →

await fetch("https://api.hookable.cc/functions/v1/push/rcp_...", {
  method: "POST",
  headers: { Authorization: "Bearer hk_...", "Content-Type": "application/json" },
  body: JSON.stringify({ title: "배포 완료", body: "main 성공 (2분 13초)" }),
});

웹훅 그대로 받기

title·body 키가 없는 JSON을 보내면 subject·name·message·text·content 같은 흔한 키를 찾아 알림으로 바꿉니다. 원문 JSON은 히스토리 상세에서 30일간 볼 수 있습니다. 이미 웹훅을 보내는 서비스의 주소만 Push URL로 바꾸면 됩니다.

curl -X POST "https://api.hookable.cc/functions/v1/push/rcp_..." \
  -H "Authorization: Bearer hk_..." \
  -H "Content-Type: application/json" \
  -d '{"event":"invoice.paid","message":"Invoice #1042 paid"}'

파라미터

이름설명
title알림 제목, 64자까지
body알림 본문, 256자까지
image첨부 이미지 https URL, 2048자까지. 잘못된 URL은 무시하고 텍스트만 보냅니다
url알림을 탭하면 바로 여는 링크. https 주소나 myapp:// 같은 앱 딥링크, 2048자까지. POST는 data.url도 됩니다
shortcut알림에서 실행할 iOS 단축어 이름
urgenttrue면 방해금지 시간·키워드 무음을 무시하고 바로 보냅니다
dataPOST 전용, 임의 JSON 객체 4KB까지

응답과 오류

상태본문의미
200{"ok":true,"delivered":1}FCM·APNs에 전달 완료. 방해금지·무음이면 delivered 0과 code가 옵니다
400payload_too_large요청 32KB 또는 data 4KB 초과
401missing_api_key / invalid_api_keyAPI 키가 없거나 이 기기의 계정 키가 아님
404invalid_recipientPush URL이 없거나 재발급됨
429rate_limited기기당 분당 30건 초과
429quota_exceeded이번 달 발송 한도 초과

한도

월 발송무료 100건 · Pro 10,000건
버스트기기당 분당 30건
히스토리무료 기기당 최근 30건 · Pro 계정당 최근 10,000건
요청 크기32KB (data 4KB)

AI 에이전트에서 쓰기

앱 My 탭의 「AI 에이전트 스킬」을 복사해 Claude Code, Codex, Cursor 같은 에이전트의 채팅에 붙여 넣거나 CLAUDE.md / AGENTS.md에 저장하세요. 에이전트가 작업을 마치거나 내 입력이 필요할 때 알아서 푸시를 보냅니다. 스킬에는 발신 API 키가 들어 있으니 신뢰하는 에이전트에만 주세요.

AI 도구용 요약은 /llms.txt, 전체 문서는 /llms-full.txt에 있습니다. 요금 →