HowlAlert

Cloudflare Worker

The HowlAlert Cloudflare Worker handles device registration and push delivery.

TL;DR — Hono-based Worker with D1 for event history and KV for device tokens. Deployed to Cloudflare's edge.

API routes

MethodPathDescription
GET/statusHealth check
POST/registerRegister device token
POST/eventSubmit usage event
GET/historyGet event history
GET/deviceList registered devices
DELETE/device/:tokenUnregister device

Storage

  • KV (HOWLALERT_DEVICES) — Device token registry, keyed by device:{userId}:{token}
  • D1 (howlalert-db) — Event history with daily aggregation queries

Authentication

All endpoints (except /status) require an Authorization: Bearer {token} header. In production this is an Apple identity token; in development any string is accepted.

On this page