Deine Website.
Deine QR-Codes.
Ein Generator, der zu deinem Unternehmen passt. Die Vasteno QR-Code-API liefert die Codes; deine Website behält ihr Design.
Persönliche Freigabe · ohne zusätzliche Vasteno-Dienste · Schlüssel bleibt auf deinem Server
POST /api/v1/qr/generate
{
"url": "https://deine-website.at",
"dotStyle": "rounded",
"format": "json"
}Passt zu deiner Website.
Links, WLAN, Kontakte, Text, E-Mail und Telefon. Farben, Formen und Logo lassen sich anpassen.
Unter deiner Kontrolle.
Schlüssel und Limits im eigenen Konto. QR-Codes führen direkt ans Ziel, ohne Weiterleitung oder Scantracking.
Mit KI einrichten.
Datei herunterladen, Prompt kopieren und deine KI übernimmt die Integration in deine bestehende Website.
Vier Schritte. Alles an einem Ort.
- 01
Anmelden & beantragen
E-Mail-Code oder Google verwenden. Website und Einsatzzweck angeben; ein Firmeneintrag ist optional.
- 02
Freigabe erhalten
Wir prüfen deine Anfrage. Die Entscheidung und deine individuellen Limits erscheinen im Konto; wir informieren dich per E-Mail.
- 03
Schlüssel & Datei holen
Schlüssel einmalig erstellen und beim Hoster sicher speichern. Passende Integrationsdatei für deine Website herunterladen.
- 04
Mit deiner KI einbauen
Prompt einfügen, Datei anhängen und dein Website-Projekt bereitstellen. Ergebnis prüfen und veröffentlichen.
Lieber persönlich klären? Schreibe an mail@vasteno.vip. Nenne deine Konto-Referenz aus dem API-Bereich, damit wir den Zugang deinem bestätigten Konto zuordnen können.
Frag deine KI. Der Prompt ist fertig.
Auch ohne Programmiererfahrung: Der Prompt erklärt API, Sicherheit und Einrichtung. Nach der Freigabe enthält er im Konto zusätzlich deine Website, Limits und die gewählte Technik.
Der Button öffnet die KI und kopiert den passenden Prompt. Dort einfügen und die Datei anhängen. Eine Web-KI kann deinen Downloads-Ordner erst nach einer Dateiübergabe lesen.
ChatGPT und Gemini: Prompt einfügen und Datei hochladen. Claude Desktop: auch direkt mit vorausgefülltem Prompt möglich. Für Änderungen am Projekt braucht die KI Zugriff auf deine Projektdateien; der Webchat allein veröffentlicht keine Website.
Eine kleine Schnittstelle. Viele Möglichkeiten.
Aufruf ausschließlich vom Server per HTTPS. Der bestehende Alias /api/qr/generate bleibt nutzbar.
Der erste Aufruf
Hinterlege VASTENO_QR_API_KEY als Server-Geheimnis. Verwende das Beispiel in deiner geschützten Serverroute mit eigener Anmeldung und Missbrauchsschutz.
const response = await fetch('https://www.vasteno.vip/api/v1/qr/generate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: 'Bearer ' + process.env.VASTENO_QR_API_KEY,
},
body: JSON.stringify({
url: 'https://deine-website.at/termin',
dotStyle: 'rounded', size: 1024, format: 'json',
}),
signal: AbortSignal.timeout(15000),
});
if (!response.ok) throw new Error('QR API: ' + response.status);
const { dataUrl, svg, usage } = await response.json();Was du zurückbekommst
dataUrl- PNG als Data-URL für Vorschau und Download.
svg- Vektorgrafik für Druck und skalierbare Downloads.
generationId/recognition- Referenz und Vasteno-Herkunftsnachweis.
usage- month, used, limit, remaining und reset.
format: "png" oder "svg" liefert direkt Bilddaten statt JSON. Alternativ Format per ?format= oder Accept-Header wählen.
Authentifizierung mit Authorization: Bearer <Schlüssel> oder X-API-Key. Browser-Aufrufe werden abgewiesen.
Inhalte & Gestaltung
| Inhalt | JSON-Beispiel |
|---|---|
| Website | {"url":"https://beispiel.at/termin"} |
| Text | {"text":"Willkommen"} |
| WLAN | {"wifi":{"ssid":"Gastnetz","password":"…","encryption":"WPA"}} |
| Kontakt | {"contact":{"firstName":"Alex","lastName":"Muster","email":"alex@beispiel.at"}} |
{"email":{"email":"mail@beispiel.at","subject":"Anfrage"}} | |
| Telefon | {"phone":"+436641234567"} |
Alternativ content mit type: auto, url, text, wifi, contact, email oder phone. WLAN: encryption WPA/WEP/nopass und hidden. Kontakt: firstName, lastName, phone, email, company, title, address, website. E-Mail: email, subject, body.
| Parameter | Werte |
|---|---|
dotStyle / cornerStyle | square, rounded, soft / square, rounded, circle |
qrColor / bgColor | Hex-Farbe #RRGGBB |
preset | black, midnight, ocean, violet, forest, berry, sand, dark |
size / iconSize | 128–4096 Pixel / 16–36 Prozent |
centerIcon | none, link, globe, wifi, mail, phone, contact, location, heart, star, bolt |
customLogo / badgeShape | HTTPS-Bild oder Bild-Data-URL / circle, rounded_square |
transparentBg / format | true oder false / json, png, svg |
Limits & Fehler
Standard bei Freigabe: 1.000 authentifizierte Aufrufe pro Monat und 60 pro Minute. Maßgeblich sind deine im Konto angezeigten Limits; andere Kontingente kannst du anfragen. Auch Aufrufe mit ungültigem QR-Inhalt zählen. Der Monat beginnt am 1. um 00:00 UTC. HTTP-Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset zeigen das Kontingent.
| HTTP | Bedeutung | Nächster Schritt |
|---|---|---|
| 400 / 413 | Ungültiger Inhalt / zu große Anfrage | Eingabe korrigieren; maximal 250 KB, QR-Inhalt 2.000 Bytes oder 1.200 mit Symbol. |
| 401 | Schlüssel fehlt oder ist ungültig | Server-Geheimnis und Header prüfen. |
| 403 | Zugang gesperrt oder Browser-Aufruf | Status im Konto prüfen; Aufruf auf den Server verlagern. |
| 429 | Minuten- oder Monatslimit | Retry-After oder reset beachten. |
| 503 | Dienst vorübergehend nicht verfügbar | Später erneut versuchen; begrenzte Wiederholungen. |
Meine Website ist statisch. Funktioniert die API trotzdem?
Du brauchst eine geschützte Serverfunktion, zum Beispiel beim vorhandenen Hoster. Der API-Schlüssel darf nicht in HTML oder JavaScript im Browser stehen. Der Integrationsprompt hilft deiner KI, die passende Lösung für deinen Hoster einzurichten.
Was enthält die Integrationsdatei?
Eine kleine Textdatei mit API-Vertrag, Einrichtungsanleitung, fertigem Prompt und Server-Beispielen für Next.js, Node.js, PHP oder WordPress. Kein Schlüssel. Sie kann als Anhang an die Web-KI übergeben oder von einer lokalen Coding-KI gelesen werden.
Welche Daten speichert Vasteno?
Antragsdaten, Statusverlauf, Schlüssel-Hashes, Nutzungszähler und Generierungsprotokolle. QR-Inhalte werden zur Erstellung an den Server übertragen; WLAN-Passwörter und Kontaktinhalte werden im Verwaltungsprotokoll maskiert. Das direkte Scan-Ziel wird nicht über Vasteno umgeleitet. Details zum Datenschutz.
Dein erster Schritt ist ein Konto.
Danach liegen Antrag, Freigabe und Integration an einem Ort.