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.