Documentation

Build with the API.

One POST to /v1/links mints a dynamic, fully-styled QR. Webhooks fire on every scan. Studio tier — token-scoped, rate-limited.

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.

Bearer token authScan webhooksREST · JSON

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 · verify your keybash
curl https://api.q.jjovan.com/v1/me \
  -H "Authorization: Bearer sk_live_8d34_kt2"

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.

POST <your_webhook_url>bash
{
  "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.

Need the full reference?

An expanded reference with every parameter and response shape is being authored alongside the v1 release.

Get API access