Référence API Zapier
Documentation complète de l'API pour l'intégration QR Code Maker avec Zapier. Comprend l'authentification OAuth 2.0, tous les endpoints, les formats de requête/réponse et les webhooks.
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.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.