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

Game da SnapQR

Sarrafa ƙirƙirar lambar QR da gajeriyar hanya ta atomatik da REST API ta kyauta: lambobi masu canzawa, ƙirƙira da yawa, fitar da nazari, tambarin UTM da sunayen yanki na musamman. Babu buƙatar maɓallin API — fara haɗawa cikin mintuna.

Tambayoyin da ake yawan yi

SnapQR na kyauta ne da gaske? Menene abin da ke ɓoye?

Ee — ƙirƙirar lambobin QR, lambobi masu canzawa, gajerun hanyoyi da nazari duk kyauta cikakke ne babu buƙatar asusu. Babu tambari kuma lambobi ba sa ƙarewa.

Mece ce bambanci tsakanin lambar QR mai tsayawa da mai canzawa?

Lambar QR mai tsayawa tana ɓoye abun cikinka kai tsaye a cikin zane kuma ba za a taɓa iya canza ta ba. Lambar QR mai canzawa tana ɓoye gajeriyar hanyar tura da kake sarrafawa, don haka za ka iya sauya inda take nunawa bayan bugawa da bin diddigin kowace duba.

Lambobin QR na za su ƙare?

A'a. Lambobi masu tsayawa ba sa daina aiki ta ƙira, kuma lambobi masu canzawa suna nan a kunne kyauta.

Yaya zan gyara lambar QR bayan bugawa?

Lokacin da ka ƙirƙiri lamba mai canzawa kana samun URL na sarrafawa na sirri. Buɗe shi, shigar da sabon inda za a nunawa sannan ka ajiye — kowace kwafin da aka buga nan take za ta nuna zuwa sabon shafin.

Zan iya ƙara tambarina a lambar QR?

Ee. Ɗora kowane hoto a cikin bangaren Zane — za a saka shi a tsakiya tare da babban gyaran kuskure don lambar ta ci gaba da dubawa yadda ya kamata. Ana sarrafa tambarin gaba ɗaya a cikin burauzarka.

Wane nazari zan samu?

Ga kowace lamba: jimillar duba, baƙi na musamman, duba a kan lokaci, nau'in na'ura, tsarin aiki, burauza, ƙasa, birni da mai tu ra da — tare da fitar da CSV. Ba a taɓa adana adiresoshin IP ba.

Wadanne nau'ikan fayiloli zan iya zazzagewa?

PNG har zuwa 4096 px (kusan inci 13 a 300 DPI) da SVG vector mai girma babu iyaka — dukansu sun dace da bugawa na ƙwararru.

Zan iya amfani da yankina na kaina don gajerun hanyoyi?

Ee — nuna CNAME zuwa snapqr.link kuma ka yi rajistar yankin ta API ɗinmu. Ana bayar da takaddun shaida na HTTPS ta atomatik.