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 단축어 이름 |
urgent | true면 방해금지 시간·키워드 무음을 무시하고 바로 보냅니다 |
data | POST 전용, 임의 JSON 객체 4KB까지 |
응답과 오류
| 상태 | 본문 | 의미 |
|---|---|---|
| 200 | {"ok":true,"delivered":1} | FCM·APNs에 전달 완료. 방해금지·무음이면 delivered 0과 code가 옵니다 |
| 400 | payload_too_large | 요청 32KB 또는 data 4KB 초과 |
| 401 | missing_api_key / invalid_api_key | API 키가 없거나 이 기기의 계정 키가 아님 |
| 404 | invalid_recipient | Push URL이 없거나 재발급됨 |
| 429 | rate_limited | 기기당 분당 30건 초과 |
| 429 | quota_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에 있습니다. 요금 →