API pro QR kódy zdarma
Potřebujete QR kód v e-shopu, na faktuře nebo v e-mailu? Pošlete obsah v adrese a dostanete obrázek. Bez registrace, bez API klíče a bez omezení počtu naskenování.
Sestavte si adresu
64 až 2048
RRGGBB bez #
RRGGBB nebo transparent
Adresa obrázku
https://kodqr.cz/api/qr?data=https%3A%2F%2Fkodqr.cz&format=png&size=512
Náhled
Adresa a odpověď
GET https://kodqr.cz/api/qr?data=…
Odpovědí je přímo obrázek (image/svg+xml nebo image/png). Stejné parametry dají vždy stejný obrázek, proto ho prohlížeče i CDN ukládají do mezipaměti a další načtení je okamžité.
Při chybném parametru vrátí API stav 400 a JSON s popisem chyby v češtině, třeba {"error":"Chybí data"}.
Parametry
| Parametr | Hodnoty | Výchozí | Popis |
|---|---|---|---|
| data | text, nejvýše 2 000 znaků | povinné | Obsah kódu. Nezapomeňte ho zakódovat pro URL (encodeURIComponent). |
| format | svg, png | svg | SVG je vektorové a ostré v jakékoli velikosti, PNG se hodí do e-mailů a dokumentů. |
| size | 64 až 2048 | 1024 | Šířka a výška obrázku v pixelech. |
| ecc | L, M, Q, H | M | Úroveň opravy chyb. Vyšší snese poškození, ale kód je hustší. |
| shape | squares, circles, rounded, diamonds | squares | Tvar modulů (teček) kódu. |
| eyeFrame | square, rounded, circle | square | Tvar vnějšího rámečku rohových čtverců. |
| eyeBall | square, rounded, circle | square | Tvar vnitřního bodu rohových čtverců. |
| darkColor | RRGGBB | 000000 | Barva kódu, šestimístný hex bez #. |
| lightColor | RRGGBB nebo transparent | FFFFFF | Barva pozadí, nebo průhledné pozadí. |
| eyeColor | RRGGBB | jako darkColor | Jiná barva rohových čtverců. |
Webhook při skenu
Kód s nastaveným webhookUrl pošle při každém skenu POST s JSON {"event": "scan", "code", "shortUrl", "device", "country", "city", "at", "sentAt"}, nikdy IP adresu. Hlavička X-Kodqr-Signature: sha256=… je HMAC-SHA256 těla s tajným klíčem z detailu kódu.
Příklady
Obrázek na webu
Stačí vložit adresu do značky <img>. Znak & se v HTML zapisuje jako &.
<img src="https://kodqr.cz/api/qr?data=https%3A%2F%2Fexample.cz&format=png&size=300"
width="150" height="150" alt="QR kód s odkazem na example.cz">Markdown (GitHub, dokumentace)
Pro README nebo wiki použijte SVG, na displejích s vysokým rozlišením zůstane ostré.

Stažení z příkazové řádky
cURL zakóduje obsah sám, když použijete --data-urlencode spolu s -G.
curl -G https://kodqr.cz/api/qr \ --data-urlencode "data=WIFI:T:WPA;S:Kavárna;P:heslo123;;" \ -d format=png -d size=1024 -o wifi.png
QR platba na faktuře
Obsah ve formátu QR Platby (SPD) si sestavíte sami, nebo ho zkopírujete z generátoru. Číslo faktury dejte do variabilního symbolu.
const spd = `SPD*1.0*ACC:${iban}*AM:${castka.toFixed(2)}*CC:CZK*X-VS:${cisloFaktury}`
const src = `https://kodqr.cz/api/qr?format=png&size=400&data=${encodeURIComponent(spd)}`Dynamické kódy a stránky za kódem
Těla požadavků jsou JSON. Vytvoření vrátí tajný token; ostatní volání ho chtějí v hlavičceAuthorization: Bearer <token>. Počet nových kódů a stránek je omezený na hodinu.
Pro e-shop nebo automatizaci (Make, n8n) si v účtu vytvořte API klíč a posílejte ho místo tokenu: Authorization: Bearer kq_…. Kódy a stránky vytvořené s klíčem patří účtu, klíč pak spravuje všechny kódy a stránky účtu i jeho týmů.
| POST /api/dynamic | {"target", "iosTarget"?, "androidTarget"?} | Nový dynamický kód, vrátí id, token a krátký odkaz. |
| GET | PATCH | DELETE /api/dynamic/<id> | Bearer token | Detail se statistikami, změna cíle, smazání. PATCH přijímá i rules (platnost, limit skenů, čas, země, jazyk), password a webhookUrl. |
| GET /api/dynamic/<id>/export?type=scans|hours|cities | Bearer token | Statistiky jako CSV. |
| POST /api/dynamic/batch | {"targets": [...], "name"?} | Skupina kódů se společným tokenem. |
| POST /api/pages | {"kind": "links|menu|file|card|wine|feedback|coupon|stamps", "content", "pin"?} | Nová stránka za kódem na /p/<id>. |
| GET | PUT | DELETE /api/pages/<id> | Bearer token | Detail, úprava obsahu, smazání stránky. |
| PUT | DELETE /api/pages/<id>/file | Bearer token, tělo = soubor | PDF nebo obrázek ke stránce, název v hlavičce X-File-Name. |
Soukromí a férové používání
Na rozdíl od generátoru na webu posíláte u API obsah kódu v adrese na server. Může se tak objevit v provozních záznamech hostingu. Hesla k WiFi a jiné citlivé údaje proto raději vytvořte v generátoru, který vše zpracuje jen ve vašem prohlížeči. Více v zásadách ochrany soukromí.
API je zdarma a bez záruky dostupnosti. Obrázky si pro opakované použití ukládejte u sebe a stovky kódů najednou vytvořte raději hromadným generováním. Logo, přechod barev a rámeček s textem API zatím neumí, ty nabízí jen generátor.