Référence API Zapier
Automatisez la création de codes QR avec l'API QR Code Maker et Zapier. Authentification OAuth 2.0, endpoints REST, webhooks et exemples d'intégration.
Référence complète de l'API pour intégrer QR Code Maker avec Zapier. Cette documentation couvre l'authentification, tous les endpoints, les formats de requête/réponse et les événements webhook.
URL de Base
https://qr-code-maker.app
Authentification
L'API utilise OAuth 2.0 avec le flux de code d'autorisation.
Flux OAuth 2.0
- Demande d'Autorisation - Rediriger l'utilisateur pour autoriser
- Code d'Autorisation - L'utilisateur approuve, reçoit le code
- Échange de Token - Échanger le code contre un token d'accès
- Requêtes API - Utiliser le token Bearer pour toutes les requêtes
- Rafraîchissement - Rafraîchir quand le token expire
Endpoint d'Autorisation
GET /oauth/authorize
Paramètres:
| Paramètre | Type | Requis | Description |
|---|---|---|---|
client_id | string | Oui | Votre ID client OAuth |
redirect_uri | string | Oui | URL de redirection |
response_type | string | Oui | Doit être code |
state | string | Oui | Chaîne pour protection CSRF |
scope | string | Non | Scopes séparés par espaces |
Scopes Disponibles:
| Scope | Description |
|---|---|
qr_codes:read | Lire les codes QR |
qr_codes:write | Créer, modifier, supprimer |
analytics:read | Accéder aux statistiques |
webhooks:write | Gérer les webhooks |
Échange de Token
POST /api/oauth/token
Durées de Vie:
| Token | Durée |
|---|---|
| Code d'autorisation | 10 minutes |
| Token d'accès | 1 heure |
| Token de rafraîchissement | 30 jours |
Rafraîchissement
POST /api/oauth/refresh
Endpoints de l'API
Toutes les requêtes nécessitent un token Bearer:
Authorization: Bearer qrc_at_xxxxxxxx
Tester la Connexion
GET /api/zapier/me
Lister les Codes QR
GET /api/zapier/qr
Créer un Code QR
POST /api/zapier/qr
Types Supportés:
| Type | Champs |
|---|---|
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": "" } |
Obtenir un Code QR
GET /api/zapier/qr/{id}
Modifier un Code QR
PATCH /api/zapier/qr/{id}
Supprimer un Code QR
DELETE /api/zapier/qr/{id}
Rechercher
GET /api/zapier/qr/search
Analyses
GET /api/zapier/qr/{id}/analytics
Dossiers
GET /api/zapier/folders
Webhooks
S'abonner
POST /api/zapier/webhooks/subscribe
Événements:
| Événement | Description |
|---|---|
qr.scanned | Code QR scanné |
qr.created | Code QR créé |
qr.milestone.1 | 1 scan atteint |
qr.milestone.10 | 10 scans atteints |
qr.milestone.50 | 50 scans atteints |
qr.milestone.100 | 100 scans atteints |
qr.milestone.500 | 500 scans atteints |
qr.milestone.1000 | 1 000 scans atteints |
qr.milestone.5000 | 5 000 scans atteints |
qr.milestone.10000 | 10 000 scans atteints |
Se Désabonner
DELETE /api/zapier/webhooks/{id}
Erreurs
Codes HTTP
| Status | Description |
|---|---|
200 | Succès |
201 | Créé |
204 | Pas de Contenu |
400 | Requête Incorrecte |
401 | Non Autorisé |
403 | Interdit |
404 | Non Trouvé |
422 | Erreur de validation |
429 | Limite dépassée |
500 | Erreur Serveur |
Limite de Taux
- Limite: 100 requêtes par minute par token
Pour Commencer
- Visitez notre intégration Zapier
- Autorisez QR Code Maker
- Créez votre premier Zap
Support
Questions? Contactez support@qr-code-maker.app.