Plus de 40 types de QR
URL, vCards, paiements et plus
Analyses en temps réel
Scans, appareils et lieux
Traitement par lots
Opérations à l'échelle de l'entreprise
Voir en action
Découvrez comment l'API génère différents styles de codes QR avec de simples appels API.
Génération de code QR simple
Créez des codes QR standard pour un usage interne, des badges d'employés ou de la documentation technique.
curl -X POST 'https://api.qrstuff.com/api/qr-codes' \
-H "Authorization: Bearer [key]" \
-H "Content-Type: application/json" \
-d '{
"type": "website",
"data": "https://example.com"
}'
{
"id": "qr_8f3k2m1n",
"status": "active",
"short_url": "https://qrs.tf/a1b2",
"image_url": "https://cdn...",
"created_at": "2026-02-12"
}
Code QR personnalisé
Marquez vos codes QR avec des couleurs personnalisées pour la vente au détail, l'hôtellerie et le marketing.
curl -X POST 'https://api.qrstuff.com/api/qr-codes' \
-d '{
"style": {
"foreground": "#5D4696",
"marker": "#E5006C"
}
}'{
"id": "qr_9x4j7p2q",
"style": {
"foreground": "#5D4696",
"marker": "#E5006C"
}
}
Présentation de l'API
L'API QRStuff est une API RESTful complète qui permet aux développeurs d'intégrer des fonctionnalités avancées de code QR directement dans leurs applications. Que vous créiez une application mobile, une plateforme Web ou un système d'entreprise, notre API fournit tout ce dont vous avez besoin.
Fonctionnalités clés
Présentation
Gestion de projet : Créez et organisez des codes QR en projets, gérez les paramètres, déplacez des codes QR entre projets et restaurez des projets supprimés.
40+ QR Code Types
Plus de 40 types de codes QR : Générez des codes QR pour sites Web, vCard, réseaux sociaux (Facebook, Instagram, LinkedIn, Twitter, YouTube, TikTok), paiements (PayPal, Bitcoin, Venmo), WiFi, événements, et fichiers (PDF, images, audio, vidéo).
Comprehensive Analytics
Analyses complètes : Accédez aux scans totaux, aux répartitions par appareil, aux données géographiques (pays/villes), aux périodes de pointe, et aux données graphiques pour vos rapports.
Batch Processing
Traitement par lots avancé : Gérez efficacement les déploiements massifs avec des téléchargements en gros (PNG, SVG, EPS, PDF) et des modèles d'impression personnalisables.
File Management
Gestion de fichiers : Stockez et récupérez des fichiers pour vos codes QR (brochures PDF, galeries d'images, fichiers audio ou vidéo).
Preview & Customization
Aperçu et personnalisation : Générez des URL d'aperçu, personnalisez les couleurs, les motifs et les logos, et contrôlez les niveaux de correction d'erreurs.
Commencer
Avant de commencer l'intégration, assurez-vous de remplir les conditions de configuration suivantes :
Active Subscription
Abonnement actif : Vous devez avoir un compte QRStuff payant. L'accès API est inclus dans tous les plans payants.
API Credentials
Identifiants API : Obtenez votre clé API unique et votre jeton d'authentification depuis votre tableau de bord.
Base URL Configuration
URL de base : Toutes les requêtes doivent être adressées au point de terminaison https://api.qrstuff.com via HTTPS.
Authentication Setup
Authentification : Incluez vos identifiants dans l'en-tête Authorization au format Bearer token.
Content Type Headers
En-têtes Content-Type : Toutes les requêtes doivent utiliser application/json.
Rate Limit Awareness
Limites de débit : Soyez conscient des limites de débit liées à votre abonnement (Standard ou Enterprise).
Exemple d'authentification
Incluez votre clé API dans l'en-tête Authorization. Voici un exemple de structure :
curl -X POST 'https://api.qrstuff.com/api/projects' \
-H "Authorization: Bearer [your_api_key]" \
-H "Content-Type: application/json" \
-d '{
"name": "Project Name"
}'Points de terminaison API
Explore the complete set of endpoints available for integrating QR code functionality into your applications.
| POST | /projects | Create a new project container for organizing QR codes |
| GET | /projects/{id} | Retrieve detailed information about a specific project |
| PUT | /projects/{id} | Update project details, settings, and configuration |
| GET | /projects | List all projects with filtering, sorting, and pagination |
| DELETE | /projects/{id} | Remove projects with soft deletion and retention |
| POST | /projects/{id}/restore | Recover deleted projects within retention period |
| POST | /qr-codes | Generate a new QR code with 40+ data types and customizations |
| GET | /projects/{id}/qr-codes | Retrieve all QR codes from a project with pagination |
| PUT | /qr-codes/{id} | Update QR code content, URLs, design, and settings |
| POST | /api/qrcodes/anonymous-transfer | Transfer QR codes between projects in bulk |
| DELETE | /qr-codes/{id} | Remove QR codes with optional soft delete and recovery |
| POST | /api/batch/submit | Initiate processing of a large batch file |
| GET | /api/qrcodes/{id}/zip/download | Download ZIP archive of all generated images |
| POST | /api/batch/unpack | Extract all QR codes from a completed batch archive |
| POST | /api/batch/update | Update properties across multiple QR codes simultaneously |
| GET | /analytics/scans | Cumulative scan counts with date range filtering |
| GET | /analytics/scans/devices | Breakdown by device type and operating system |
| GET | /analytics/location | Geographic data with country, state, and city-level detail |
| GET | /analytics/top-location | Discover regions with highest engagement rates |
| GET | /analytics/top-date | Identify peak scanning days and dates |
| GET | /analytics/time-of-day | Hourly breakdown of scanning patterns |
| GET | /analytics/unique-users | Track individual user engagement and loyalty |
| GET | /analytics/charts/country | Country-wise distribution for charting libraries |
| GET | /analytics/charts/time | Time-series data for visual scan pattern charts |
| POST | /files | Upload files (PDF, images, audio, video) with validation |
| GET | /files/{id} | Retrieve file info, download URLs, and metadata |
| GET | /files | Browse uploaded files with pagination and filtering |
| DELETE | /files/{id} | Remove files with active-use protection check |
Types de codes QR pris en charge (40+)
Générez des codes pour une grande variété d'usages :
Informations de base et contact
7Réseaux Sociaux
15Localisation et Événements
3Fichiers et Documents
5Paiements et Transactions
5Marketing et Engagement
6Affaires et Utilitaires
4Note : Chaque type de code QR a des paramètres spécifiques. Consultez la documentation sur api.qrstuff.com/docs.
Bonnes pratiques
Utilisez des codes QR dynamiques : Permet de mettre à jour le contenu sans réimprimer et de suivre les statistiques.
Gestion des erreurs : Vérifiez les codes HTTP (200, 400, 401, 429, 500) et gérez les limites de débit.
Opérations par lots : Utilisez les lots pour les volumes importants afin de réduire les appels API.
Mise en cache intelligente : Cachez les images et données statiques, mais gardez les analyses fraîches.
Sécurité : Ne JAMAIS exposer vos clés API côté client. Utilisez des variables d'environnement.
Cas d'utilisation réels
Gestion d'événements et Billetterie
Générez des codes QR uniques pour chaque billet, suivez les entrées en temps réel et organisez plusieurs événements via les projets.
Gestion d'inventaire et d'actifs
Suivez l'emplacement et l'historique de vos équipements. Utilisez le traitement par lots pour les nouveaux stocks.
Campagnes Marketing et Analyses
Créez des campagnes traçables, testez différentes pages de destination et mesurez le ROI en temps réel.
Contenu Éducatif et Engagement
Liez vos supports de cours à des vidéos ou modèles 3D. Suivez l'engagement des étudiants par ressource.
Restauration et Hôtellerie
Menus numériques sans contact, commandes à table et collecte d'avis instantanée.
English (US)
English (UK)
Spanish (ES)