Zapier API-referentie
Volledige API-documentatie voor de QR Code Maker Zapier-integratie. Bevat OAuth 2.0-authenticatie, alle endpoints, request/response formaten en webhooks.
Volledige API-referentie voor het integreren van QR Code Maker met Zapier. Deze documentatie behandelt authenticatie, alle endpoints, request/response formaten en webhook events.
Basis-URL
https://qr-code-maker.app
Authenticatie
De API gebruikt OAuth 2.0 met authorization code flow.
OAuth 2.0 Flow
- Autorisatieverzoek - Gebruiker doorsturen om te autoriseren
- Autorisatiecode - Gebruiker keurt goed, ontvangt code
- Token-uitwisseling - Code inwisselen voor access token
- API-requests - Bearer token voor alle requests
- Token vernieuwen - Vernieuwen wanneer access token verloopt
Autorisatie-endpoint
GET /oauth/authorize
Query Parameters:
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
client_id | string | Ja | Je OAuth client ID |
redirect_uri | string | Ja | Redirect URL na autorisatie |
response_type | string | Ja | Moet code zijn |
state | string | Ja | Willekeurige string voor CSRF |
scope | string | Nee | Door spaties gescheiden scopes |
Beschikbare Scopes:
| Scope | Beschrijving |
|---|---|
qr_codes:read | QR-codes lezen |
qr_codes:write | QR-codes maken, bijwerken, verwijderen |
analytics:read | Scanstatistieken bekijken |
webhooks:write | Webhooks beheren |
Token-uitwisseling
POST /api/oauth/token
Token Levensduur:
| Token | Levensduur |
|---|---|
| Autorisatiecode | 10 minuten |
| Access token | 1 uur |
| Refresh token | 30 dagen |
Token Vernieuwen
POST /api/oauth/refresh
API Endpoints
Alle requests vereisen een Bearer token:
Authorization: Bearer qrc_at_xxxxxxxx
Verbinding Testen
GET /api/zapier/me
QR-codes Ophalen
GET /api/zapier/qr
QR-code Maken
POST /api/zapier/qr
Ondersteunde Types:
| Type ID | Content |
|---|---|
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 Ophalen
GET /api/zapier/qr/{id}
QR-code Bijwerken
PATCH /api/zapier/qr/{id}
QR-code Verwijderen
DELETE /api/zapier/qr/{id}
Zoeken
GET /api/zapier/qr/search
Analytics
GET /api/zapier/qr/{id}/analytics
Mappen
GET /api/zapier/folders
Webhooks
Abonneren
POST /api/zapier/webhooks/subscribe
Events:
| Event | Beschrijving |
|---|---|
qr.scanned | QR-code gescand |
qr.created | QR-code gemaakt |
qr.milestone.100 | 100 scans bereikt |
qr.milestone.500 | 500 scans bereikt |
qr.milestone.1000 | 1.000 scans bereikt |
qr.milestone.5000 | 5.000 scans bereikt |
qr.milestone.10000 | 10.000 scans bereikt |
Afmelden
DELETE /api/zapier/webhooks/{id}
Foutafhandeling
HTTP Statuscodes
| Status | Beschrijving |
|---|---|
200 | Succes |
201 | Gemaakt |
204 | Geen Content |
400 | Ongeldige Request |
401 | Niet Geautoriseerd |
403 | Verboden |
404 | Niet Gevonden |
422 | Validatiefout |
429 | Rate Limit |
500 | Serverfout |
Rate Limit
- Limiet: 100 requests per minuut per access token
Aan de Slag
- Bezoek onze Zapier-integratie
- Autoriseer QR Code Maker
- Maak je eerste Zap
Support
Vragen? Neem contact op via support@qr-code-maker.app.