Getting started
The API is hosted at api.q.jjovan.com/v1. Every request is JSON in, JSON out. Auth is bearer tokens you generate in settings → API keys.
Authentication
Send your key as Authorization: Bearer sk_live_…. Keys are scoped to a single workspace and rotate from the dashboard. Revoke from there too — takes effect within 60 seconds.
curl https://api.q.jjovan.com/v1/me \ -H "Authorization: Bearer sk_live_8d34_kt2"
Create a link
POST a target URL and optional style preset. The response carries a shortened slug and a signed download URL for SVG, PNG, and animated SVG.
curl https://api.q.jjovan.com/v1/links \
-H "Authorization: Bearer sk_live_8d34_kt2" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://anjapetrović.rs/live",
"slug": "anja-show",
"style_preset": "ember-gradient",
"landing": {
"title": "Live show — Friday 9pm",
"subtitle": "Drina Hall · scan for tickets"
}
}'{
"id": "lnk_7nP4xKr2",
"slug": "anja-show",
"short_url": "https://q.jjovan.com/anja-show",
"landing_url": "https://q.jjovan.com/p/anja-show",
"exports": {
"svg": "https://cdn.q.jjovan.com/lnk_7nP4xKr2.svg",
"png": "https://cdn.q.jjovan.com/lnk_7nP4xKr2.png",
"anim": "https://cdn.q.jjovan.com/lnk_7nP4xKr2.anim.svg"
},
"created_at": "2026-05-14T11:42:18Z"
}Scan webhook
Register a webhook URL once. Every scan POSTs a signed payload within 200ms of the redirect — no polling, no batches. IPs are hashed before they ever leave the edge.
{
"event": "link.scanned",
"link_id": "lnk_7nP4xKr2",
"slug": "anja-show",
"scanned_at": "2026-05-14T19:08:42.187Z",
"device": "ios.safari",
"country": "RS",
"referer": null,
"ip_hash": "5b9c4f…"
}Errors
- 400invalid_requestBody did not match the schema. The issues array lists every offending field.
- 401unauthorizedMissing or revoked token.
- 404not_foundSlug does not exist or you do not own it.
- 409slug_takenPick another slug or let us generate one.
- 429rate_limitedThrottle yourself or upgrade.
Rate limits
Studio tier ships with 60 requests per minute and 12,000 per day, burstable to 180 for 10 seconds. Hit a limit and you get a 429 with retry_after seconds.