Quickstart

Erstellen Sie Ihren ersten dynamischen QR-Code in weniger als einer Minute. MostlyQR-Codes sind dynamisch — Sie drucken den QR-Code einmal und können ihn für immer umleiten, mit integrierten Scan-Analysen. Die meisten verwenden das Dashboard; diese Anleitung ist für die REST API.

# 1. Einen API-Schlüssel erhalten

Erstellen Sie einen Schlüssel in der App unter Settings → API keys. Schlüssel sehen wie mtq_live_… (Produktion) oder mtq_test_… (Testen) aus. Senden Sie ihn bei jeder Anfrage als Bearer-Token. Siehe Authentication.

# 2. Einen dynamischen Link erstellen

bash

curl https://mostlyqr.com/api/v1/links \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "destination_url": "https://northbrew.co/spring-menu", "title": "Spring menu" }'

json

{
  "code": "AZ4K9",
  "short_url": "https://mqr.sh/AZ4K9",
  "destination_url": "https://northbrew.co/spring-menu",
  "title": "Spring menu",
  "status": "active"
}

Konvertieren Sie short_url in einen QR-Code (beliebiger Generator oder der Dashboard-Builder) und drucken Sie ihn aus. Bei jedem Scan wird ein 302-Redirect zur Zielseite durchgeführt — und es wird gezählt.

# 3. Ändern Sie das Ziel — kein Neudruck erforderlich

bash

curl -X PATCH https://mostlyqr.com/api/v1/links/AZ4K9 \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "destination_url": "https://northbrew.co/summer-menu" }'

Jedes bereits gedruckte Exemplar wird sofort auf die neue URL aufgelöst. Der Code verfällt niemals — auch wenn Sie die Zahlung einstellen, bleibt er bei seiner letzten Zielseite hängen, anstatt einen 404-Fehler zu verursachen.

# 4. Scans lesen

bash

curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
  -H "Authorization: Bearer mtq_live_…"

Siehe Analytics für die vollständige Struktur (Geo, Gerät, Zeit).

# Nächste Schritte

Dynamic links — jede Option für die /v1/links Endpunkte.
Batch — erstellen Sie tausende Codes in einem Aufruf.
Serialized codes — ein eindeutiger Code pro physische Einheit (Enterprise).
Verification — die öffentliche „ist dies echt?"-Überprüfung.
Die vollständige API reference.