📆 curtlink.xyz

Secure link shortener with 24h valid links

Python version GitHub repo size GitHub last commit Website Status

What is curtlink.xyz

It's basically ANOTHER link shortener. But why is it special, you might ask? Shortened links are only valid for 24 hours and shortened domains have to support SSL (and have it corectly set up) and not be on our blocklist. In the future, curtlink.xyz might check popular malicious domain blacklists to be extra secure. curtlink.xyz also generates a handy QR code for you.

How to use

curtlink.xyz can be used comfortably from the web interface, but it also supports HTTP API requests. Here is a small documentation of how to use it.

⬇ GET Meta

Gets the metadata of the shortened URL. This includes its slug, expiry, and redirect location.

GET /api/v1/meta/{slug}
Query Parameter Type Description
slug string Required. The slug of the shortened URL (e.g. https://curtlink.xyz/r/2sa837)

Response (Valid link) [200]

{
  "detail": "Link available",
  "slug": "2sa837",
  "expiry": "2022-04-12 20:51:14.429058",
  "redirect": "https://example.com"
}

Response (Expired link) [404]

{
  "detail": "Link expired",
  "slug": "2sa837"
}

⬆ POST Create

Gets the metadata of the shortened URL. This includes its slug, expiry, and redirect location.

POST /api/v1/create
Body Parameter Type Description
url string Required. The URL you would like to shorten (e.g. https://example.com)

Response (Success) [200]

{
  "detail": "Link created",
  "slug": "2sa837",
  "expiry": "2022-04-12 20:51:14.429058",
  "redirect": "https://example.com"
}

Response (SSL Error) [403]

{
  "detail": "SSL Error"
}

Response (Blocked) [403]

{
  "detail": "Domain blocked by curtlink.xyz"
}

Made possible by DETA ❤️

Sponsored by Deta