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"}'

Ynghylch SnapQR

Awtomeiddiwch greu codau QR a dolenni byr gydag API REST am ddim: codau deinamig, cynhyrchu swmp, allforio dadansoddeg, tagio UTM a pharthau personol. Dim angen allwedd API — dechreuwch integreiddio mewn munudau.

Cwestiynau cyffredin

A yw SnapQR wir am ddim? Beth yw'r ddalfa?

Ydy — mae creu codau QR, codau deinamig, dolenni byr a dadansoddeg 100% am ddim heb angen cyfrif. Nid oes dyfrnod ac nid yw codau'n dod i ben.

Beth yw'r gwahaniaeth rhwng cod QR statig a chod QR deinamig?

Mae cod QR statig yn amgodio'ch cynnwys yn uniongyrchol yn y patrwm ac ni ellir byth ei newid. Mae cod QR deinamig yn amgodio URL ailgyfeirio byr rydych chi'n ei reoli, felly gallwch newid ble mae'n pwyntio ar ôl argraffu ac olrhain pob sganiad.

A yw fy nghodau QR yn dod i ben?

Na. Nid yw codau statig byth yn peidio â gweithio wrth eu cynllunio, ac mae codau deinamig yn aros yn weithredol am ddim.

Sut ydw i'n golygu cod QR ar ôl argraffu?

Pan grëwch god deinamig, cewch URL rheoli preifat. Agorwch ef, rhowch y cyrchfan newydd a chadwch — mae pob copi wedi'i argraffu'n pwyntio ar unwaith at y dudalen newydd.

A allaf ychwanegu fy logo at god QR?

Gallwch. Uwchlwythwch unrhyw ddelwedd yn y panel Dylunio — mae'n cael ei fewnosod yn y canol gyda chywiro gwallau uchel fel bod y cod yn dal i sganio'n ddibynadwy. Mae'r logo'n cael ei brosesu'n gyfan gwbl yn eich porwr.

Pa ddadansoddeg ydw i'n ei gael?

Fesul cod: cyfanswm sganiadau, ymwelwyr unigryw, sganiadau dros amser, math o ddyfais, system weithredu, porwr, gwlad, dinas ac atgyfeiriwr — gydag allforio CSV. Ni chedwir cyfeiriadau IP byth.

Pa fformatau ffeil y gallaf eu lawrlwytho?

PNG hyd at 4096 px (tua 13 modfedd ar 300 DPI) a fector SVG y gellir ei raddio'n ddiddiwedd — mae'r ddau'n addas ar gyfer argraffu proffesiynol.

A allaf ddefnyddio fy mharth fy hun ar gyfer dolenni byr?

Gallwch — pwyntiwch CNAME at snapqr.link a chofrestrwch y parth trwy ein API. Cyhoeddir tystysgrifau HTTPS yn awtomatig.