Introduction

rzwn.link is a personal link shortener. Short links look like rzwn.link/<slug> and redirect to a destination URL you specify. Every redirect is logged for analytics (referrer, geo, device, browser, OS), and shared links get a proper OpenGraph preview card instead of just following through to the destination.

There is no web UI. Everything is driven through a small REST API, meant to be used by a client app (an iOS app, a CLI, etc).

Quickstart

Create your first short link and check its stats.

Authentication

How to authenticate requests to the API.

Links

Create, list, update, and delete short links.

Stats

Per-link and global click analytics.

How it works

POST /api/links creates a short link, either with an auto-generated slug or a custom one you specify.
GET /<slug> is the public redirect endpoint. It 307-redirects real visitors to the destination URL and logs a click.
Known link-unfurling crawlers (iMessage, Slack, Discord, Twitter, etc.) get an OpenGraph HTML page instead of a redirect, so shares show a proper preview card and never count as a click.
GET /api/links/:slug/stats and GET /api/stats expose click analytics: totals, clicks over time, top referrers/countries, device/browser/OS breakdowns, and recent click history.

No raw IP addresses are ever stored. Unique-visitor counts are derived from a salted, daily-rotating hash of the visitor's IP.