Welche Authentifizierungsmethode verwendet die API?

Die API verwendet OAuth 2.0 mit Authorization Code Flow. Access Tokens laufen nach 1 Stunde ab und können mit dem Refresh Token erneuert werden, der 30 Tage gültig ist.

Was sind die API-Ratenlimits?

Die API erlaubt 100 Anfragen pro Minute pro Access Token. Überschreitung dieses Limits gibt einen 429-Statuscode mit einem Retry-After-Header zurück.

Wie kann ich die API-Verbindung testen?

Verwende den GET /api/zapier/me Endpunkt mit deinem Bearer-Token. Eine erfolgreiche Antwort bestätigt, dass deine Authentifizierung korrekt funktioniert.

Zapier API-Referenz

Vollständige API-Referenz für die Integration von QR Code Maker mit Zapier. Diese Dokumentation behandelt Authentifizierung, alle verfügbaren Endpunkte, Anfrage-/Antwortformate und Webhook-Events.

Basis-URL

https://qr-code-maker.app

Authentifizierung

Die API verwendet OAuth 2.0 mit dem Authorization Code Flow.

OAuth 2.0 Flow

Autorisierungsanfrage - Benutzer zur Autorisierung weiterleiten
Autorisierungscode - Benutzer genehmigt, erhält Code
Token-Austausch - Code gegen Access Token tauschen
API-Anfragen - Bearer-Token für alle Anfragen verwenden
Token-Aktualisierung - Aktualisieren wenn Access Token abläuft

Autorisierungs-Endpunkt

GET /oauth/authorize

Abfrageparameter:

Parameter	Typ	Erforderlich	Beschreibung
`client_id`	string	Ja	Deine OAuth Client ID
`redirect_uri`	string	Ja	URL zur Weiterleitung nach Autorisierung
`response_type`	string	Ja	Muss `code` sein
`state`	string	Ja	Zufällige Zeichenkette für CSRF-Schutz
`scope`	string	Nein	Durch Leerzeichen getrennte Scopes

Verfügbare Scopes:

Scope	Beschreibung
`qr_codes:read`	QR-Codes und ihre Details lesen
`qr_codes:write`	QR-Codes erstellen, aktualisieren und löschen
`analytics:read`	Auf Scan-Statistiken zugreifen
`webhooks:write`	Webhook-Abonnements verwalten

Token-Austausch

POST /api/oauth/token

Token-Lebenszeiten:

Token	Lebensdauer
Autorisierungscode	10 Minuten
Access Token	1 Stunde
Refresh Token	30 Tage

Token-Aktualisierung

POST /api/oauth/refresh

Hinweis: Refresh-Tokens werden bei jeder Verwendung rotiert.

API-Endpunkte

Alle Anfragen erfordern einen Bearer-Token:

Authorization: Bearer qrc_at_xxxxxxxx

Verbindung testen

GET /api/zapier/me

QR-Codes auflisten

GET /api/zapier/qr

QR-Code erstellen

POST /api/zapier/qr

Unterstützte Typen:

Typ-ID	Inhaltsfelder
`website`	`{ "url": "https://..." }`
`vcard`	`{ "firstName": "", "lastName": "", ... }`
`wifi`	`{ "ssid": "", "password": "", "security": "WPA" }`
`email`	`{ "email": "", "subject": "", "body": "" }`
`sms`	`{ "phone": "", "message": "" }`
`phone`	`{ "phone": "" }`
`text`	`{ "text": "" }`
`event`	`{ "title": "", "startDate": "", "endDate": "", "location": "" }`

QR-Code abrufen

GET /api/zapier/qr/{id}

QR-Code aktualisieren

PATCH /api/zapier/qr/{id}

QR-Code löschen

DELETE /api/zapier/qr/{id}

QR-Codes suchen

GET /api/zapier/qr/search

QR-Code-Analysen

GET /api/zapier/qr/{id}/analytics

Ordner auflisten

GET /api/zapier/folders

Webhooks

Event	Beschreibung
`qr.scanned`	QR-Code gescannt
`qr.created`	Neuer QR-Code erstellt
`qr.milestone.100`	100 Scans erreicht
`qr.milestone.500`	500 Scans erreicht
`qr.milestone.1000`	1.000 Scans erreicht
`qr.milestone.5000`	5.000 Scans erreicht
`qr.milestone.10000`	10.000 Scans erreicht

Abbestellen

DELETE /api/zapier/webhooks/{id}

Fehlerbehandlung

HTTP-Statuscodes

Status	Beschreibung
`200`	Erfolg
`201`	Erstellt
`204`	Kein Inhalt
`400`	Ungültige Anfrage
`401`	Nicht autorisiert
`403`	Verboten
`404`	Nicht gefunden
`422`	Validierungsfehler
`429`	Ratenlimit überschritten
`500`	Serverfehler

Ratenlimit

Limit: 100 Anfragen pro Minute pro Access Token

Erste Schritte

Besuche unsere Zapier-Integration
Autorisiere QR Code Maker
Erstelle deinen ersten Zap

Support

Fragen? Kontaktiere support@qr-code-maker.app.