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

Náhled QR kódu z API

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

ParametrHodnotyVýchozíPopis
datatext, nejvýše 2 000 znakůpovinnéObsah kódu. Nezapomeňte ho zakódovat pro URL (encodeURIComponent).
formatsvg, pngsvgSVG je vektorové a ostré v jakékoli velikosti, PNG se hodí do e-mailů a dokumentů.
size64 až 20481024Šířka a výška obrázku v pixelech.
eccL, M, Q, HMÚroveň opravy chyb. Vyšší snese poškození, ale kód je hustší.
shapesquares, circles, rounded, diamondssquaresTvar modulů (teček) kódu.
eyeFramesquare, rounded, circlesquareTvar vnějšího rámečku rohových čtverců.
eyeBallsquare, rounded, circlesquareTvar vnitřního bodu rohových čtverců.
darkColorRRGGBB000000Barva kódu, šestimístný hex bez #.
lightColorRRGGBB nebo transparentFFFFFFBarva pozadí, nebo průhledné pozadí.
eyeColorRRGGBBjako darkColorJiná 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 &amp;.

<img src="https://kodqr.cz/api/qr?data=https%3A%2F%2Fexample.cz&amp;format=png&amp;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é.

![QR kód](https://kodqr.cz/api/qr?data=https%3A%2F%2Fexample.cz)

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 tokenDetail 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|citiesBearer tokenStatistiky 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 tokenDetail, úprava obsahu, smazání stránky.
PUT | DELETE /api/pages/<id>/fileBearer token, tělo = souborPDF 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.