qrgratisAPI

QR-Code-API

Erzeuge QR-Codes für URL und Text als SVG oder PNG über einen einzigen GET-Aufruf. Kostenlos, ohne Anmeldung, ohne API-Schlüssel. Es werden nur einfache Typen unterstützt — keine Kontaktdaten, keine IBANs, keine Nutzerdaten.

Endpunkt

GET https://qr-gratis.com/api/qr

Parameter

NameWerteDefaultBedeutung
typeurl · texturlurl verlangt eine gültige http(s)-URL, text nimmt beliebigen Text.
dataStringDer Inhalt. Alternativ unter dem typgleichen Namen (url= oder text=). Max. 1200 Zeichen.
formatpng · svgpngAusgabeformat. SVG ist verlustfrei skalierbar, PNG rastert auf das Modulraster.
eclL · M · Q · HMFehlerkorrektur. Höher = robuster, aber dichter.
size64–2000512Kantenlänge in Pixeln.
margin0–324Ruhezone in Modulen.
dark#RRGGBB#000000Vordergrundfarbe (6-stelliges Hex).
light#RRGGBB#ffffffHintergrundfarbe (6-stelliges Hex).

Beispiele

Als Bild einbinden:

<img src="https://qr-gratis.com/api/qr?type=url&data=https%3A%2F%2Fqr-gratis.com&format=svg&dark=%230F766E&size=240"
     width="240" height="240" alt="QR-Code" />

Ergebnis:

Beispiel-QR-Code als SVG

Farbige SVG-Ausgabe (dark=#0F766E). Auf dem Kommandozeilenweg:

curl -o qr.png \
  "https://qr-gratis.com/api/qr?type=text&data=Hallo&format=png"

Ratenbegrenzung

Bis zu 30 Anfragen pro Minute und IP. Wird das überschritten, antwortet die API mit Status 429 und einem Retry-After-Header. Die Antworten sind über die URL vollständig bestimmt und werden daher zwischengespeichert — binde denselben Code als statisches Bild ein, statt ihn bei jedem Aufruf neu zu ziehen.

Fehler

Ungültige Parameter liefern Status 400 mit einer JSON-Meldung ({ "error": "…" }). Inhalt, der die QR-Kapazität sprengt, liefert 422.

Hinweis

Dies ist der einzige serverseitig ausgeführte Teil des Projekts. Für den vollen Funktionsumfang — Logos, Verläufe, WLAN, vCard, EPC/GiroCode, Scan-Prüfung — nutze den Generator im Browser. Dort verlassen die Eingaben dein Gerät nie.