Webhook Receiver
Receives inbound webhooks, forwards notifications to the configured backend, and provides utility endpoints.
Registered Routes
POST
/gitlab
GitLab webhook handler
Validates
X-Gitlab-Token, parses push / MR / pipeline events, forwards to the configured notifier. Only registered when GITLAB_SECRET is set.
GET
/ip
Caller IP echo
Returns your apparent public IP as seen by the server.
POST
/notify
Direct notification
Requires
Fields:
X-API-Key header.Fields:
title, message, topic (required)priority: low · normal · high · critical
GET
/dns
DNS lookup proxy
Resolve DNS from outside your firewall. Requires authentication.
Params:
Batch:
Params:
name (required), type (A, AAAA, MX, TXT, CNAME, NS, PTR — default A), server (optional — literal public IP only, e.g. 8.8.8.8 or [2001:4860:4860::8888]:53; defaults to container resolver).Batch:
POST /dns/batch accepts a JSON array of lookups (max 20).
GET
/probe
TCP reachability check
TCP reachability check from the server. Params:
host, port, optional timeout (s, max 10). Requires X-API-Key.
GET
/health
Health check endpoint
Returns
{"status":"ok"}. Used by Traefik health probes.