QRCode Suitefür WordPress
AnmeldenKostenlos starten →
Dokumentation

REST-API-Quickstart

QRCode Suite stellt eine versionierte REST-API unter `/wp-json/meliqs/v1/` auf der WordPress-Instanz bereit. Dieses Walkthrough führt Sie vom Erstellen Ihres ersten API-Keys über das Anlegen eines QR bis zum Abruf von Scan-Daten — insgesamt fünf HTTP-Requests, mit Curl- und Postman-Beispielen pro Schritt.

  1. 1

    API-Key erstellen

    Im WordPress-Admin: QR Suite → API Keys → Erstellen. Key benennen, Scope wählen (`read`, `read-write` oder `admin`), Secret sofort kopieren — wird nur einmal angezeigt. Format: `qcs_live_<32-hex>`. Im Environment als `QCS_API_KEY` speichern.

  2. 2

    Dynamischen QR anlegen

    POST an `/wp-json/meliqs/v1/qrs` mit Header `Authorization: Bearer $QCS_API_KEY` und Body `{"type": "url", "target": "https://example.com/landing", "name": "API test"}`. Liefert QR-ID, kodierte Kurz-URL, Metadaten. ID für die nächsten beiden Calls notieren.

  3. 3

    Scan-Analyse abrufen

    GET `/wp-json/meliqs/v1/qrs/{id}/scans?from=2026-01-01&to=2026-05-01` liefert paginierte Scan-Events: gehashte IP, Land, Gerät, Referrer, UTM. Standard-Page-Größe 100; für größere Queries `page=2&per_page=200` bis 1000 pro Seite.

  4. 4

    QR-Ziel aktualisieren

    PATCH `/wp-json/meliqs/v1/qrs/{id}` mit Body `{"target": "https://example.com/new-destination"}`. Antwortet 200 mit aktualisiertem Record. Der gedruckte QR löst sofort auf das neue Ziel auf — kein Nachdruck, kein Cache-Flush nötig.

  5. 5

    Webhooks für Echtzeit-Scans

    Webhook-URL für jedes Event abonnieren: POST an `/wp-json/meliqs/v1/webhooks` mit Body `{"url": "https://ihr-server.example/scan-hook", "events": ["scan.created"]}`. Jeder Scan triggert nun einen HMAC-signierten POST an Ihren Endpoint innerhalb 200 ms.

Häufig gestellte Fragen

Was ist QRCode Suite?

QRCode Suite ist ein Premium-WordPress-Plugin, das markenkonforme dynamische QR-Codes direkt in Ihrem WordPress-Dashboard erstellt. Scan-Daten werden auf Ihrem eigenen Server gespeichert — nicht auf einer SaaS-Plattform von Dritten — und WooCommerce-Bestellungen können einzelnen QR-Codes zugeordnet werden.

Benötigt QRCode Suite ein separates Abonnement?

Der Free-Plan ist kostenlos verfügbar. Bezahlpläne (Pro, Business, Agency) werden pro WordPress-Site lizenziert und monatlich oder jährlich abgerechnet. Es gibt keine Gebühr pro Scan.

Welche QR-Code-Typen unterstützt QRCode Suite?

QRCode Suite unterstützt 15 QR-Code-Typen: URL, vCard, Wi-Fi, SMS, E-Mail, WhatsApp, PDF, Coupon, Klartext, Social-Profil, WooCommerce-Produkt, WooCommerce-Nachbestellung, Link Hub, Telefon und Dynamische URL.

Kann ich das Ziel eines QR-Codes nach dem Druck ändern?

Ja. Dynamische QR-Codes nutzen eine kurze Weiterleitungs-URL. Sie können das Ziel jederzeit aus Ihrem WordPress-Dashboard heraus aktualisieren, ohne den Code neu zu erstellen oder zu drucken.

Ist QRCode Suite DSGVO-konform?

Ja. QRCode Suite hasht IP-Adressen vor dem Speichern mit SHA-256, sodass nie unverarbeitete IPs gespeichert werden. Das Plugin filtert außerdem automatisch Bot-Traffic und bietet konfigurierbare Datenaufbewahrungseinstellungen.

Hilfe beim Einstieg?

Laden Sie das kostenlose Plugin herunter oder durchsuchen Sie die Dokumentation.

Plugin herunterladenAlle Docs