★ API v1 · Business
Documentazione API
L'API REST iziqrcode permette di creare, gestire e tracciare i tuoi QR programmaticamente.
Quickstart
Crea il tuo primo QR tramite l'API in meno di 5 minuti
Autenticazione
Come generare e usare le chiavi API con scopes
Webhooks
Ricevi notifiche in tempo reale sui tuoi endpoint
Rate limiting
Limiti al minuto, all'ora e al giorno
Base URL
Tutti gli endpoint sono disponibili su:
https://iziqrcode.com/api/v1Autenticazione
L'API usa token Bearer. Genera la tua chiave da /app/api-keys e inseriscila nell'header Authorization:
curl https://iziqrcode.com/api/v1/qr \
-H "Authorization: Bearer izi_live_xxxxx..."Formato delle risposte
L'API restituisce JSON per ogni risposta. Codici di stato HTTP standard:
2xxSuccesso — la richiesta è andata a buon fine
4xxErrore del client — controlla la richiesta
5xxErrore del server — riprova più tardi
Rate limiting
3 finestre scorrevoli per chiave / account:
- 60 richieste / minuto per chiave API
- 5.000 richieste / ora per chiave API
- 5.000 richieste / giorno per account
Ogni risposta include X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Viene restituito un 429 Too Many Requests con un header Retry-After al raggiungimento del limite.
Specifica OpenAPI
Specifica leggibile dalla macchina su /api/v1/openapi — importabile in Postman / Insomnia / openapi-typescript. Il visualizzatore Swagger interattivo si trova su /api-docs.