Documentazione API

Crea codici QR e codici a barre dal tuo prodotto con una REST API. Invia JSON a /api/v1, ricevi grafica SVG ospitata, poi elenca o aggiorna le stesse risorse.

Crea un codice QR

POST /api/v1/qr-codes con type, contenuto e design opzionale: colori, stile dei moduli, logo, occhi e cornice. La risposta include un URL SVG ospitato.

{
  "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
}
Riferimento creazione QR

Crea un codice a barre

POST /api/v1/barcodes con una simbologia, value e colori o dimensioni opzionali. Sono disponibili trentaquattro tipi, da Code 128 a EAN-13.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
Riferimento creazione codice a barre

Autenticazione

Invia la chiave API come token Bearer in ogni richiesta. Puoi visualizzarla o rigenerarla in Dashboard → Account → API.

Authorization: Bearer YOUR_API_KEY

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

Limiti di frequenza

Ogni chiave API è limitata a 60 richieste al minuto. Le risposte includono le intestazioni X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

Errori

Gli errori usano il formato JSON:API:

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

Gli errori di validazione possono includere source.pointer.