Quale metodo di autenticazione usa l'API?

L'API usa OAuth 2.0 con flusso del codice di autorizzazione. I token di accesso scadono dopo 1 ora e possono essere aggiornati con il refresh token, valido 30 giorni.

Quali sono i limiti di velocità dell'API?

L'API permette 100 richieste al minuto per token di accesso. Superare questo limite restituisce codice 429 con header Retry-After.

Come posso testare la connessione API?

Usa l'endpoint GET /api/zapier/me con il tuo token Bearer. Una risposta positiva conferma che l'autenticazione funziona.

Riferimento API Zapier

Riferimento completo dell'API per integrare QR Code Maker con Zapier. Questa documentazione copre autenticazione, tutti gli endpoint, formati richiesta/risposta ed eventi webhook.

URL Base

https://qr-code-maker.app

Autenticazione

L'API usa OAuth 2.0 con flusso del codice di autorizzazione.

Flusso OAuth 2.0

Richiesta di Autorizzazione - Reindirizzare l'utente per autorizzare
Codice di Autorizzazione - L'utente approva, riceve il codice
Scambio Token - Scambiare il codice per token di accesso
Richieste API - Usare token Bearer per tutte le richieste
Aggiornamento Token - Aggiornare quando il token scade

Endpoint di Autorizzazione

GET /oauth/authorize

Parametri:

Parametro	Tipo	Richiesto	Descrizione
`client_id`	string	Sì	Il tuo ID client OAuth
`redirect_uri`	string	Sì	URL di reindirizzamento
`response_type`	string	Sì	Deve essere `code`
`state`	string	Sì	Stringa per protezione CSRF
`scope`	string	No	Scope separati da spazi

Scope Disponibili:

Scope	Descrizione
`qr_codes:read`	Leggere codici QR
`qr_codes:write`	Creare, aggiornare, eliminare
`analytics:read`	Accedere alle statistiche
`webhooks:write`	Gestire webhook

Scambio Token

POST /api/oauth/token

Durata Token:

Token	Durata
Codice di autorizzazione	10 minuti
Token di accesso	1 ora
Refresh token	30 giorni

Aggiornamento Token

POST /api/oauth/refresh

Endpoint dell'API

Tutte le richieste richiedono token Bearer:

Authorization: Bearer qrc_at_xxxxxxxx

Testare Connessione

GET /api/zapier/me

Elencare Codici QR

GET /api/zapier/qr

Creare Codice QR

POST /api/zapier/qr

Tipi Supportati:

Tipo	Campi
`website`	`{ "url": "https://..." }`
`vcard`	`{ "firstName": "", "lastName": "", ... }`
`wifi`	`{ "ssid": "", "password": "", "security": "WPA" }`
`email`	`{ "email": "", "subject": "", "body": "" }`
`sms`	`{ "phone": "", "message": "" }`
`phone`	`{ "phone": "" }`
`text`	`{ "text": "" }`
`event`	`{ "title": "", "startDate": "", "endDate": "", "location": "" }`

Ottenere Codice QR

GET /api/zapier/qr/{id}

Aggiornare Codice QR

PATCH /api/zapier/qr/{id}

Eliminare Codice QR

DELETE /api/zapier/qr/{id}

Cercare

GET /api/zapier/qr/search

Analisi

GET /api/zapier/qr/{id}/analytics

Cartelle

GET /api/zapier/folders

Webhook

Iscriversi

POST /api/zapier/webhooks/subscribe

Eventi:

Evento	Descrizione
`qr.scanned`	QR scansionato
`qr.created`	QR creato
`qr.milestone.100`	100 scansioni
`qr.milestone.500`	500 scansioni
`qr.milestone.1000`	1.000 scansioni
`qr.milestone.5000`	5.000 scansioni
`qr.milestone.10000`	10.000 scansioni

Annullare Iscrizione

DELETE /api/zapier/webhooks/{id}

Gestione Errori

Codici HTTP

Status	Descrizione
`200`	Successo
`201`	Creato
`204`	Nessun Contenuto
`400`	Richiesta Non Valida
`401`	Non Autorizzato
`403`	Vietato
`404`	Non Trovato
`422`	Errore Validazione
`429`	Limite Superato
`500`	Errore Server

Limite di Velocità

Limite: 100 richieste al minuto per token

Per Iniziare

Visita la nostra integrazione Zapier
Autorizza QR Code Maker
Crea il tuo primo Zap

Supporto

Domande? Contatta support@qr-code-maker.app.