QR Vello Dokumentation
Technische Dokumentation, API-Referenz und Guides für QR Vello.
Willkommen in der QR Vello Dokumentation. Diese Doku beschreibt den aktuellen Produktstand: das QR-Dashboard, die öffentliche API, Workspaces, Custom Domains, Bulk-Jobs und Webhooks.
Status auf einen Blick
| Bereich | Status | Was das bedeutet |
|---|---|---|
| QR-Dashboard | Live | Codes, Analytics, Design, Bulk, Domains, Workspaces und Webhooks sind als Produktoberfläche vorhanden. |
| Public REST API v1 | Public Beta | Die v1-Endpunkte für QR-Codes sind dokumentiert und API-Key-basiert. Erweiterte Admin-Endpunkte bleiben Dashboard-intern. |
| Signierte Webhooks | Beta | Endpoints, Secrets und Testzustellung sind im Dashboard angelegt. Event-Abdeckung wird schrittweise erweitert. |
| SSO, SCIM, On-Prem | Enterprise/Roadmap | SSO wird pro Enterprise-Setup geklärt. SCIM und On-Prem sind keine Self-Service-Funktionen. |
Schnellstart
- Lege unter
/qr/codesdeinen ersten dynamischen Code an. Der vollständige Ablauf steht im Guide QR-Code erstellen. - Prüfe unter
/qr/codesScanstatus, Ziel-URL, Design und Preflight. - Erzeuge unter
/qr/api-keyseinen API-Key, wenn du die Public API nutzen willst. - Richte unter
/qr/domainseine eigene Kurz-Domain ein, wenn der Scan sichtbar zu deiner Marke gehören soll. - Nutze
/qr/webhooks, wenn dein System über neue QR-Events informiert werden soll.
Guides
- QR-Code erstellen: Typen, Payloads, Design, Preflight, Versionen und API-Beispiele.
- Dashboard-Guide: Codes, Analytics, Design und Organisation.
- API-Referenz v1: Auth, Basis-URL, Public-v1-Endpunkte und Beispiel-Requests.
- Custom Domains: DNS, Verifikation, TLS, primäre Domain, Code-Zuweisung, Dashboard-API und Troubleshooting.
- Workspaces: Rollen, Einladungen, Audit-Log und Mandantentrennung.
- Bulk-Import: CSV-Upload, Jobs, Downloads und Wiederholung.
- Webhooks: Secrets, Signaturen, Testzustellung und Event-Status.
Was bewusst nicht versprochen wird
Einige Enterprise-Themen hängen an Vertrag, Setup oder Roadmap. Deshalb werden sie in den öffentlichen Seiten nur noch mit Status genannt:
- SDKs: geplant, aber nicht als allgemein verfügbare Downloads beworben.
- OAuth2 für fremde Frontends: private Preview, nicht als Self-Service-Produkt.
- SCIM: Roadmap, nur in Enterprise-Gesprächen einplanen.
- On-Prem: Architekturprüfung pro Kunde, kein Standardplan.
- Public Status Page: vorbereitet, aber erst nach Livegang verlinkt.
Hilfe
Wenn dir in dieser Doku ein Detail fehlt, schreib uns über /contact.
API- oder Enterprise-Fragen bitte mit geplantem Use Case und erwartetem Volumen
beschreiben, damit wir direkt konkret antworten können.