Der QR-Code für Ihre Rechnungen, mit einem Aufruf.

Code erzeugen

Ein POST mit dem Inhalt im Body. Der Inhalt steht nie in der Adresse, damit er nicht in den Logs von Servern unterwegs landet.

curl https://api.qrsensei.com/v1/qr \
  -H "Authorization: Bearer $QRSENSEI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": {
    "type": "text",
    "text": "FT 2026/118 · 149,90 EUR"
  },
  "brand": "qrsensei",
  "style": {
    "color": {
      "kind": "solid",
      "color": "#18181B"
    }
  },
  "format": "png",
  "size": 256
}'

Request-Body

Antwort

{
  "image": "data:image/png;base64,iVBORw0KGgo…",
  "format": "png",
  "remaining": 902,
  "limit": 1000,
  "resetsAt": "2026-12-01T00:00:00.000Z"
}

Dieselben Zahlen stehen in den Headern X-QrSensei-Remaining, X-QrSensei-Limit und X-QrSensei-Reset.

Authentifizierung

Jeder Aufruf trägt den Schlüssel Ihrer Anwendung im Header Authorization: Bearer qs_live_….

• Der Schlüssel wird nur einmal gezeigt, beim Erstellen. Wir behalten nur einen Fingerabdruck: Geht er verloren, erstellen Sie im Profil einen neuen, und der alte funktioniert nicht mehr.
• Rufen Sie von Ihrem Server auf, nie aus einem Browser oder einer App: Ein Schlüssel im Frontend-Code kann von jedem gelesen werden.
• Von den Codes wird nichts gespeichert: weder Inhalt noch Bilder. Nur eine Zählung pro Monat.

Inhalte

Dieselben Typen wie im Editor, mit denselben Regeln. Diese Tabelle wird aus den Regeln gelesen, die jeden Aufruf prüfen: Sie kann nicht veralten.

Ein WLAN ohne Passwort bekommt encryption "nopass". Ein weggelassenes Feld bleibt leer; ein fehlendes Pflichtfeld wird im detail des Fehlers genannt.

Stile

Im Profil gestaltet, mit dem Code live daneben. Jeder hat eine id, einer ist Ihr Standard; oder schreiben Sie den Stil direkt in den Aufruf, als style.

{}

{ "color": { "kind": "solid", "color": "#18181B" }, "background": { "kind": "transparent" }, "quietZone": 2 }

{ "dots": "dots", "finders": "drop", "color": { "kind": "gradient", "type": "linear", "angle": 45, "stops": [ "#0F172A", "#1E40AF" ] }, "background": { "kind": "solid", "color": "#FFF7ED" } }

Ein Stil wird nur angenommen, wenn er lesbar ist: Formen, die zusammenpassen, und Tinte dunkler als ihr Papier, mit mindestens 4,5:1 Kontrast. Ein transparenter Code wird gegen Weiß geprüft, das Papier einer Rechnung.

Marken

"auto" erkennt die Marke am Link (ein Instagram-Link bekommt das Instagram-Logo). Ein Name legt die Marke fest; "none" lässt die Mitte frei. Die Liste kommt auch von GET /v1/brands.

Gegen Phishing: Auf einem Link wird eine festgelegte Marke nur verwendet, wenn der Link ihr gehört. Das Logo einer Bank landet nie auf einem gefälschten Link.

• qrsensei
• instagram
• facebook
• linkedin
• x
• tiktok
• youtube
• github
• spotify
• whatsapp
• telegram
• signal
• viber
• snapchat
• pinterest
• threads
• discord
• reddit
• messenger
• googleMaps
• appleMaps
• waze
• paypal
• revolut
• wise
• stripe

Limits

Fehler

Immer ein error-Objekt mit code, message und, wo es hilft, detail: Der code ist für Ihr Programm, die message für Menschen. Ein Aufruf mit Fehler wird nicht gezählt.