san . st

san.st URL Shortener API

v1.0.0

Privacy-first URL shortening with DLUS dual-layer safety scanning.

Base URL:  https://api.san.st OpenAPI JSON ↗
POST
/api/shorten

Shorten a URL

Request Body application/json

Field Type Required
url string required
alias string optional

Responses

200 Short link created
400 Missing or invalid url
500 Server error

Example

curl -X POST "https://api.san.st/api/shorten" \
  -H "Content-Type: application/json" \
  -d '{"url":"<url>","alias":"<alias>"}'
PUT
/api/alias

Set a custom alias

Request Body application/json

Field Type Required
code string required
alias string required

Responses

200 Alias set
400 Invalid parameters
409 Alias taken or reserved

Example

curl -X PUT "https://api.san.st/api/alias" \
  -H "Content-Type: application/json" \
  -d '{"code":"<code>","alias":"<alias>"}'
GET
/api/check

Check URL safety (DLUS)

Query Parameters

url string required

Responses

200 Safety check result
400 Missing url

Example

curl "https://api.san.st/api/check?url=%3Curl%3E"
GET
/api/stats

Site-wide statistics

Responses

200 Site statistics

Example

curl "https://api.san.st/api/stats"
POST
/api/v1/links

Shorten a URL with ARLMP-22 metadata (public)

Request Body application/json

Field Type Required
destination string required

Responses

201 Short link created with ARLMP-22 metadata
400 Missing or invalid destination

Example

curl -X POST "https://api.san.st/api/v1/links" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<destination>"}'
GET
/api/v1/links/{id}/metadata

Get ARLMP-22 metadata (public)

Path Parameters

id string required

Responses

200 ARLMP-22 metadata object
404 Link not found

Example

curl "https://api.san.st/api/v1/links/{id}/metadata"
GET
/{code}/stats

Per-link statistics

Path Parameters

code string required

Responses

200 Link statistics
404 Not found

Example

curl "https://api.san.st/{code}/stats"
GET
/{code}

Redirect short link

Path Parameters

code string required

Responses

302 Redirect
404 Not found

Example

curl "https://api.san.st/{code}"
← Back to san.st