SnapQR API

Create and manage QR codes and short links programmatically. No API key, no signup — the token returned at creation is the credential for that link. Base URL: https://snapqr.link/api

Create a link / dynamic QR

POST /api/links
Content-Type: application/json

{
  "kind": "url",                  // url | appstore | vcard | page
  "target": "https://example.com/menu",
  "alias": "summer-menu",         // optional custom code
  "title": "Summer menu",         // optional
  "campaign": "summer",           // optional grouping tag
  "utm": {                        // optional, auto-appended on redirect
    "utm_source": "poster", "utm_medium": "qr", "utm_campaign": "summer2026"
  }
}

Response 201:

{
  "code": "summer-menu",
  "short_url": "https://snapqr.link/summer-menu",
  "qr_png": "https://snapqr.link/summer-menu/qr.png",
  "qr_svg": "https://snapqr.link/summer-menu/qr.svg",
  "manage_url": "https://snapqr.link/m/<token>",
  "token": "<token>"            // keep secret — grants edit + analytics access
}

For kind: "appstore" send ios, android, fallback URLs. For kind: "vcard" send firstName, lastName, org, jobTitle, phone, email, website. For kind: "page" send headline, description and a links array of {label, url}.

Manage & analytics

GET    /api/manage/{token}            # link details + totals
PUT    /api/manage/{token}            # update target/payload/utm/active/title
DELETE /api/manage/{token}            # delete link + analytics
GET    /api/manage/{token}/stats?days=30
GET    /api/manage/{token}/scans.csv  # raw scan export

/stats returns totals, unique visitors, a per-day series and top-10 breakdowns for device, OS, browser, country, city, referrer and QR-vs-link source.

Bulk creation

POST /api/bulk            # JSON array of link objects, or {"csv": "alias,target,title,campaign\n..."}
POST /api/bulk?format=csv  # same, responds with a CSV of created codes

Max 500 rows per request.

QR images

GET /api/qr?data=hello&size=1024&fg=%23000000&bg=%23ffffff&format=png|svg&ecl=M
GET /{code}/qr.png   GET /{code}/qr.svg    # QR for an existing short code

Custom domains

POST /api/domains  {"domain": "qr.yourbrand.com"}

Then point a CNAME for that hostname at snapqr.link. TLS certificates are issued automatically on first visit, and your short codes resolve on your own domain.

Limits

Fair-use rate limits apply per IP (60 links/hour, 10 bulk requests/hour, 300 QR images/hour). Destinations must be public http(s) URLs. Codes serving malware or phishing are removed.

Example: curl

curl -X POST https://snapqr.link/api/links \
  -H "Content-Type: application/json" \
  -d '{"kind":"url","target":"https://example.com","alias":"demo-123"}'

Maidir le SnapQR

Uathoibrigh cruthú cód QR agus nasc gearr le REST API saor in aisce: cóid dhinimiciúla, giniúint ollmhéide, easpórtáil anailísíochta, clibeáil UTM agus fearainn saincheaptha. Níl eochair API ag teastáil — tosaigh ag comhtháthú i gceann nóiméad.

Ceisteanna coitianta

An bhfuil SnapQR saor in aisce i ndáiríre? Cad é an chleas?

Tá — tá cóid QR, cóid dhinimiciúla, naisc ghearra agus anailísíocht a chruthú 100% saor in aisce gan gá le cuntas. Níl comhartha uisce ar bith ann agus ní théann cóid in éag.

Cad é an difríocht idir cód QR statach agus dinimiciúil?

Ionchódaíonn cód QR statach do chuid ábhair go díreach sa phatrún agus ní féidir é a athrú riamh. Ionchódaíonn cód QR dinimiciúil URL atreoraithe gearr a rialaíonn tú, mar sin is féidir leat a athrú cá dtéann sé tar éis priontála agus gach scanadh a rianú.

An dtéann mo chóid QR in éag?

Ní théann. Ní stopann cóid statacha ag obair riamh de réir a ndearaidh, agus fanann cóid dhinimiciúla gníomhach saor in aisce.

Conas a chuirim cód QR in eagar tar éis priontála?

Nuair a chruthaíonn tú cód dinimiciúil faigheann tú URL bainistíochta príobháideach. Oscail é, cuir an ceann scríbe nua isteach agus sábháil — díríonn gach cóip phriontáilte ar an leathanach nua láithreach.

An féidir liom mo lógó a chur le cód QR?

Is féidir. Uaslódáil aon íomhá sa phainéal Dearaidh — leabaítear é sa lár le ceartú earráidí ard ionas go scanann an cód go hiontaofa fós. Próiseáiltear an lógó go hiomlán i do bhrabhsálaí.

Cén anailísíocht a fhaighim?

In aghaidh gach cóid: scananna iomlána, cuairteoirí uathúla, scananna le himeacht ama, cineál gléis, córas oibriúcháin, brabhsálaí, tír, cathair agus atreoraí — le heaspórtáil CSV. Ní stóráiltear seoltaí IP riamh.

Cé na formáidí comhaid is féidir liom a íoslódáil?

PNG suas le 4096 px (thart ar 13 orlach ag 300 DPI) agus veicteoir SVG in-scálaithe gan teorainn — tá an dá cheann oiriúnach do phriontáil ghairmiúil.

An féidir liom mo fhearann féin a úsáid le haghaidh nasc gearr?

Is féidir — dírigh CNAME ar snapqr.link agus cláraigh an fearann trínár API. Eisítear teastais HTTPS go huathoibríoch.