Skip to main content

​
Purr API

The core backend API for SMO1 link management and analytics.

​
Base URL

EnvironmentURL
Kittenhttp://localhost:8080
Cathttps://api.staging.smo1.io
Lionhttps://api.smo1.io

​
Health Check

GET /health
Returns service health status including database connectivity. 
POST /api/v1/links
Authorization: Bearer <token>
Content-Type: application/json

{
  "url": "https://example.com/very-long-url",
  "custom_uid": "my-link",
  "expires_at": "2025-12-31T23:59:59Z"
}

GET /api/v1/links/:uid
Authorization: Bearer <token>

GET /api/v1/links?page=1&per_page=20
Authorization: Bearer <token>

DELETE /api/v1/links/:uid
Authorization: Bearer <token>

​
Analytics

GET /api/v1/links/:uid/analytics?period=7d
Authorization: Bearer <token>

​
Authentication

See Authentication for details on obtaining tokens.