GET /v1/qr?data=https://deinedomain.de&size=300
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 33 33"> … </svg>
Auf jede Rechnung soll ein Code, der direkt zur Zahlungsseite führt — 400 Rechnungen im Monat, jede mit einer anderen Nummer. Ein Generator im Netz macht dir genau einen Code, von Hand. Und viele davon hängen an einem Kurzlink des Anbieters, der irgendwann kostenpflichtig wird oder verschwindet; dann sind alle gedruckten Codes tot.
Der Encoder deckt die QR-Versionen 1 bis 5 im Byte-Modus ab. Ab 85 Byte lehnt die API mit dem Fehler too_long ab, statt ein Muster zu erzeugen, das keine Kamera liest. Gezählt werden Bytes, nicht Zeichen: Ein Umlaut oder ein ß braucht in UTF-8 zwei Byte, ein Emoji vier. Das Wort „Öffnungszeiten“ hat also 14 Zeichen, zählt aber als 15 Byte.
| Inhalt bis … | Version | Raster |
|---|---|---|
| 14 Byte | 1 | 21 × 21 Module |
| 26 Byte | 2 | 25 × 25 |
| 42 Byte | 3 | 29 × 29 |
| 62 Byte | 4 | 33 × 33 |
| 84 Byte | 5 | 37 × 37 |
Die Version wählt die API selbst, du kannst sie nicht erzwingen — je kürzer der Inhalt, desto gröber das Muster und desto kleiner darfst du drucken. Ebenso wenig wählbar ist die Fehlerkorrektur: Sie steht fest auf Stufe M und gleicht damit rund 15 Prozent gestörte Fläche aus. Was nicht hineinpasst: ein vollständiger vCard-Datensatz mit Anschrift, und meist auch ein GiroCode nach EPC069-12 — der kommt je nach Empfängername und Verwendungszweck auf etwa 75 bis 110 Byte und reißt die Grenze, sobald der Firmenname etwas länger ist.
Die Ausgabe ist immer SVG — kein PNG, kein JPEG und keine Transparenz: Der helle Grund liegt als eigenes Rechteck unter dem Muster und füllt auch den Randbereich. Wer den Code auf farbigen Untergrund setzen will, gibt diese Farbe als light mit, statt sie freizustellen. Drei Stellschrauben gibt es:
| Parameter | Erlaubt | Standard |
|---|---|---|
size | 64–2000 (Kantenlänge in Pixel) | 320 |
margin | 0–16 Module heller Rand | 4 |
dark / light | sechsstelliger Hexwert, # optional | #000000 / #ffffff |
Farbnamen wie rot, Kurzformen wie #f00 und Alphawerte werden mit invalid_color abgelehnt — lieber ein klarer Fehler als ein Code, den später niemand scannen kann. Das führende Doppelkreuz darfst du weglassen: dark=0f5d57 funktioniert genauso.
size ist eine Obergrenze, keine Zusage: Jedes Modul bekommt eine ganze Zahl von Pixeln, damit die Kanten scharf bleiben. Ein Version-1-Code mit dem voreingestellten Rand ist 29 Module breit; bei size=300 ergibt das 10 Pixel je Modul und eine Datei von 290 × 290, bei size=320 sind es 11 Pixel und 319. Am unteren Ende fällt das Bild sogar kleiner aus als das erlaubte Minimum — size=64 liefert 58 Pixel. Für den Druck ist das gleichgültig, für ein Layout mit fester Pixelbreite nicht: Dort rechnest du mit der Breite, die im SVG steht, nicht mit der angefragten.
Als SVG — verlustfrei skalierbar von der Visitenkarte bis zum Messebanner, mit frei wählbarer Vorder- und Hintergrundfarbe. SVG lässt sich direkt in Websites, PDFs und Druckvorlagen einbetten.
Ja, solange der Kontrast stimmt: dunkle Module auf hellem Grund. Die API erzeugt standardkonforme Codes mit Fehlerkorrektur — bis zu 30 % der Fläche dürfen beschädigt oder überlagert sein und der Code bleibt lesbar.
Bis zu etwa 2.900 Zeichen, praktisch nutzt man aber kurze URLs — je weniger Inhalt, desto gröber und robuster das Muster. Tipp: Kombiniere mit der Kurz-URL-API, dann bleibt der Code auch auf kleinen Flächen scanbar.
Da die Ausgabe SVG ist, kannst du dein Logo einfach mittig darüberlegen — die Fehlerkorrektur ist standardmäßig hoch genug, dass der Code lesbar bleibt, solange das Logo unter etwa einem Viertel der Fläche bleibt.
Nein — der QR-Code enthält deine Daten direkt und funktioniert für immer, unabhängig von uns. Nur wenn du eine Kurz-URL codierst, hängt die Weiterleitung an deren Bestand.
Aktuell ist alles in der Beta komplett kostenlos — keine Kreditkarte, keine Laufzeit. Nach dem Verkaufsstart beginnen die Tarife bei 3,50 € pro Monat (10.000 Aufrufe) — bewusst rund die Hälfte des üblichen Marktpreises. Wer in der Beta dabei ist, wird vor jeder Umstellung informiert.
E-Mail-Adresse in das Formular auf dieser Seite eintragen — der API-Schlüssel erscheint sofort, ohne Bestätigungs-Wartezeit. Damit hast du 1.000 Aufrufe pro Monat frei. Der Schlüssel wird als Hash gespeichert und nur einmal angezeigt, also direkt sicher ablegen.
E-Mail eintragen, Schlüssel erscheint sofort auf der Seite. Kein Konto, keine Kreditkarte, keine Freischaltung durch uns.
Ein einziger HTTP-Aufruf mit deinem Schlüssel im Kopf — aus jeder Programmiersprache, jedem Framework, jedem Automatisierungswerkzeug.
Du bekommst sauberes JSON oder die fertige Datei zurück. Fehler kommen als klare deutsche Meldung, nicht als Rätsel.
GET /v1/qr?data=https://deinedomain.de&size=300
Wir legen die Preise jetzt schon offen, damit du planen kannst. Beta-Nutzer werden rechtzeitig informiert, bevor sich etwas ändert — niemand wird automatisch in einen bezahlten Tarif überführt.
Alle Preise zuzüglich Umsatzsteuer. Monatlich kündbar, keine Mindestlaufzeit, keine Einrichtungsgebühr.
Verwandt: Screenshot-API · PDF-API · Bild-API · Website-Archiv