Documentation API

Créez des QR codes et des codes-barres depuis votre produit via une API REST. Envoyez du JSON à /api/v1, recevez des visuels SVG hébergés, puis listez ou mettez à jour les mêmes ressources.

Créer un QR code

POST /api/v1/qr-codes avec un type, un contenu et un design optionnel : couleurs, style de module, logo, yeux et cadre. La réponse inclut une URL SVG hébergée.

{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}
Référence de création QR

Créer un code-barres

POST /api/v1/barcodes avec une symbologie, une value et des couleurs ou une taille optionnelles. Trente-quatre types sont disponibles, de Code 128 à EAN-13.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
Référence de création de code-barres

Authentification

Envoyez votre clé API en Bearer sur chaque requête. Retrouvez ou régénérez-la dans Tableau de bord → Compte → API.

Authorization: Bearer YOUR_API_KEY

URL de base: https://forqrcode.com/api/v1

Limites de débit

Chaque clé API est limitée à 60 requêtes par minute. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sont inclus.

Erreurs

Les erreurs suivent le format JSON:API :

{ "errors": [{ "title": "…", "status": "422" }] }

Les erreurs de validation peuvent inclure source.pointer.