api API REST

Intégrez
FRQR
partout.

Une API REST complète pour créer des QR codes, raccourcir des liens et gérer vos assets marketing directement depuis votre code.

Lire la documentation open_in_new Obtenir une clé API
check_circle OpenAPI 3.1
check_circle JSON:API
check_circle Auth Bearer
check_circle Rate-limit 1000/min
POST /v1/qr-codes
// Créer un QR code dynamique
const res = await fetch('https://frqr.app/api/v1/qr-codes', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    destination: 'https://mon-site.fr/promo',
    label: 'Campagne été 2026',
    style: {
      foreground: '#0ea5e9',
      logo_url: 'https://mon-site.fr/logo.png'
    }
  })
});

const { data } = await res.json();
// data.id, data.qr_url, data.scan_url
console.log(data.qr_url);
// → "https://frqr.app/qr/abc123.svg"
201 Created — 47ms
Endpoints principaux

Tout ce dont vous avez besoin

Des routes RESTful complètes pour chaque ressource. Full CRUD, pagination, filtres et webhooks inclus.

GET
/v1/qr-codes
Lister vos QR codes avec pagination et filtres par label, date, destination.
POST
/v1/qr-codes
Créer un QR code dynamique avec style, destination et options de tracking.
PATCH
/v1/qr-codes/{id}
Modifier la destination d'un QR code sans changer le code imprimé.
GET
/v1/short-links
Récupérer tous vos liens courts avec stats de clics incluses.
POST
/v1/short-links
Raccourcir une URL avec alias personnalisé, expiration et protection par mot de passe.
GET
/v1/analytics/{id}
Statistiques détaillées : clics, pays, appareils, évolution temporelle.
POST
/v1/webhooks
Enregistrer une URL pour recevoir les événements en temps réel (scan, clic, lead).
DELETE
/v1/qr-codes/{id}
Archiver ou supprimer un asset. Les données analytics sont conservées.
SDKs officiels

Code moins,
livrez plus vite.

Nos SDKs gèrent l'authentification, la sérialisation, la pagination et les retries automatiquement. Concentrez-vous sur votre produit.

check_circle Authentification automatique via Bearer token
check_circle Retry exponentiel sur 429 et 5xx
check_circle Types TypeScript inclus dans le SDK JS
check_circle Support Python 3.10+, async/await natif
check_circle Exemples et recettes dans la documentation
check_circle Changelog versionné semver
SDK JavaScript
npm · frqr-js
$ npm i frqr-js

import { FrqrClient } from 'frqr-js';

const frqr = new FrqrClient({
  apiKey: process.env.FRQR_API_KEY
});

const qr = await frqr.qrCodes.create({
  destination: 'https://example.com'
});
SDK Python
pip · frqr-python
$ pip install frqr

from frqr import FrqrClient

client = FrqrClient(
  api_key=os.environ["FRQR_API_KEY"]
)

qr = client.qr_codes.create(
  destination="https://example.com"
)
POST → votre-site.fr/hooks/frqr
// Payload reçu à chaque scan
{
  "event": "qr_code.scanned",
  "timestamp": "2026-05-18T14:32:11Z",
  "data": {
    "qr_code_id": "qr_abc123",
    "destination": "https://mon-site.fr/promo",
    "country": "FR",
    "city": "Paris",
    "device": "mobile",
    "os": "iOS",
    "scan_count_total": 1847
  },
  "signature": "sha256=..."
}
Webhooks temps réel

Réagissez à
chaque scan.

Abonnez-vous aux événements et déclenchez vos propres workflows en moins de 100ms. CRM, analytics, alertes, automatisations — le webhook fait le lien.

qr_code.scanned Chaque scan de QR code avec géo et device
short_link.clicked Chaque clic sur un lien court
lead.captured Nouveau lead capturé via squeeze page
qr_code.updated Destination modifiée
subscription.renewed Renouvellement de plan

Qui intègre l'API ?

De la startup au grand groupe, l'API FRQR s'adapte à vos besoins d'intégration.

storefront

E-commerce

Générez des QR codes produit à la volée lors de chaque mise en ligne sur votre boutique.

print

Agences print

Intégrez la création de QR codes dans vos workflows InDesign ou Figma via des scripts.

apartment

Hôtellerie

Créez des liens Wi-Fi, menus et services en chambre personnalisés par numéro de chambre.

event_available

Événementiel

Générez des QR codes nominatifs pour chaque participant directement depuis votre CRM.

business_center

SaaS & apps

Enrichissez vos exports clients avec des QR codes branded sans quitter votre interface.

analytics

Marketing

Automatisez la création de liens trackés pour chaque campagne depuis votre outil d'automation.

Votre première requête en 2 minutes.

Créez un compte, générez votre clé API et appelez votre premier endpoint. C'est tout.

Obtenir une clé API gratuitement arrow_forward Lire la documentation open_in_new

100 requêtes/jour offertes sur le plan gratuit