URL Shortener API

https://url.keychain.pl

POST /api/shorten

Shorten a URL. Body is JSON with a single url field. Returns the new record and a fully qualified short_url you can hand to a browser.

Request

curl -X POST https://url.keychain.pl/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/some/long/path"}'

Response 201

{
  "id": "aZ3kQ9m",
  "target_url": "https://example.com/some/long/path",
  "created_at": "2026-07-04T18:22:31Z",
  "click_count": 0,
  "short_url": "https://url.keychain.pl/aZ3kQ9m"
}

Try it

Shorten

The form posts JSON via the _demo hint; your browser will show the raw response.

Errors

Status	Cause
400	Body is not valid JSON.
422	url missing or not an http(s) URL.

GET /:id

Resolve a short id to its target. Increments click_count atomically and returns a 302 Found to the original URL.

Request

curl -i https://url.keychain.pl/aZ3kQ9m
# HTTP/1.1 302 Found
# Location: https://example.com/some/long/path

Errors

Status	Cause
404	No record exists for that id.

GET /api/urls/:id

Read metadata for a single short URL. Useful for building a stats dashboard without following the redirect.

Request

curl https://url.keychain.pl/api/urls/aZ3kQ9m

Response 200

{
  "id": "aZ3kQ9m",
  "target_url": "https://example.com/some/long/path",
  "created_at": "2026-07-04T18:22:31Z",
  "click_count": 4
}

GET /api/urls

List every short URL this server knows about, newest first.

Request

curl https://url.keychain.pl/api/urls

Response 200

{
  "count": 2,
  "urls": [
    {
      "id": "aZ3kQ9m",
      "target_url": "https://example.com/some/long/path",
      "created_at": "2026-07-04T18:22:31Z",
      "click_count": 4
    },
    {
      "id": "b7H2nXp",
      "target_url": "https://sinatrarb.com/",
      "created_at": "2026-07-04T18:25:02Z",
      "click_count": 0
    }
  ]
}