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

Ku SnapQR

Kola koodi za QR n'enkolagana empimpi mu ngeri ey'okwekola n'API REST ey'obwereere: koodi eziyeekyusa, okukola mu bibinja, okuggya okwekenneenya, okuteekako UTM, ne dominoosi ez'obwannannyini. Tewetaagisa kisumuluzo kya API — tandika okugatta mu ddakiika ntono.

Ebibuuzo ebibuuzibwa ennyo

SnapQR mazima kya bwereere? Kkweka ki?

Yee — okukola koodi za QR, koodi eziyeekyusa, enkolagana empimpi n'okwekenneenya bya bwereere ku 100% awatali kaawunti. Tewali kabonero era koodi tezikoma.

Njawulo ki eriwo wakati wa koodi ya QR eteeyeekyusa n'eyeekyusa?

Koodi ya QR eteeyeekyusa etereka ebirimu byo butereevu mu nkola era teyinza kukyusibwa n'akatono. Koodi ya QR eyeekyusa etereka URL ey'okusindika empimpi gy'ofuga, kw'osobola okukyusa gy'eraga oluvannyuma lw'okukuba ku kyapa n'olondoola buli kusoma.

Koodi zange eza QR zikoma?

Nedda. Koodi eteeyeekyusa tezikoma kukola olw'enkola yaazo, ne koodi eziyeekyusa zisigala nga zikola nga za bwereere.

Nnaddamu ntya koodi ya QR oluvannyuma lw'okukuba ku kyapa?

Bw'okola koodi eyeekyusa ofuna URL ey'okuddukanya ey'ekyama. Giggule, oteekemu ekifo ekiggya osindike — buli koppi eyakubiddwa mangu eraga ku lupapula olupya.

Nsobola okuteeka loogo yange ku koodi ya QR?

Yee. Teekamu ekifaananyi kyonna mu paneeli eya Design — kizingibwa wakati n'okugonjoola ensobi okwa waggulu koodi n'esobola okusomebwa obulungi. Loogo ekolebwa yonna mu buulaza yo.

Kwekenneenya ki kwe nfuna?

Ku buli koodi: okusoma kwonna, abagenyi ab'enjawulo, okusoma okw'ekiseera, ekika ky'ekyuma, sisitemu y'okukola, buulaza, ensi, ekibuga n'ekyaggibbwako — n'okuggya CSV. Endagiriro za IP tezitwalibwa n'akatono.

Fayiro za ngeri ki ze nsobola okuggya?

PNG okutuuka ku 4096 px (nga sentimita 33 ku 300 DPI) ne SVG eya vekita esobola okugaziwa awatali kukoma — byombi bisaanira okukuba okw'ekikugu.

Nsobola okukozesa dominyo yange ku nkolagana empimpi?

Yee — laga CNAME ku snapqr.link era wandiise dominyo ng'oyita mu API yaffe. Satifikeeti za HTTPS ziweebwa mu ngeri ey'okwekola.