Chiavi API

Autentica le richieste API con chiavi API sicure.

Panoramica

Le chiavi API ti permettono di:

• Autenticare richieste API
• Integrare con sistemi esterni
• Automatizzare workflow richieste foto
• Costruire applicazioni personalizzate

Requisito Piano

L'accesso API richiede un piano che include funzionalità API.

Creare una Chiave API

Passaggi

1. Vai a Chiavi API nella barra laterale
2. Clicca Crea Chiave API
3. Inserisci un nome descrittivo
4. Attiva Attivo (default: attivo)
5. Clicca Crea

Salva la Tua Chiave

Visualizzazione Una Tantum

La chiave API completa viene mostrata solo una volta alla creazione. Copiala e conservala in modo sicuro. Non potrai recuperarla dopo.

Dopo la creazione:

• Copia la chiave immediatamente
• Conserva in una posizione sicura
• Non condividere mai pubblicamente

Usare le Chiavi API

Header di Autenticazione

Includi la chiave API negli header della richiesta:

curl -X GET "https://api.visio.now/v1/status" \
  -H "X-API-Key: your-api-key-here"

Nome Header

Header	Valore
X-API-Key	La tua chiave API

Esempio Richiesta

# Crea una richiesta foto
curl -X POST "https://api.visio.now/v1/photo-requests" \
  -H "X-API-Key: vsk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Per favore invia foto del veicolo",
    "photo_slots": [
      {"instructions": "Vista frontale", "is_required": true},
      {"instructions": "Vista posteriore", "is_required": true}
    ]
  }'

Gestire le Chiavi API

Visualizzare Chiavi

La lista Chiavi API mostra:

• Nome chiave
• Chiave mascherata (visualizzazione parziale)
• Stato attivo/inattivo
• Data ultimo utilizzo
• Data creazione

Modificare Chiave

1. Clicca l'icona modifica
2. Aggiorna il nome
3. Attiva/disattiva stato attivo
4. Salva modifiche

Disattivare Chiave

Disabilita temporaneamente una chiave:

1. Clicca Disattiva sulla chiave
2. Conferma l'azione
3. La chiave smette immediatamente di funzionare

Attivare Chiave

Riabilita una chiave disattivata:

1. Clicca Attiva sulla chiave
2. Conferma l'azione
3. La chiave funziona di nuovo immediatamente

Rigenerare Chiave

Crea un nuovo valore chiave:

1. Clicca Rigenera
2. Conferma l'azione (la vecchia chiave smette di funzionare)
3. Copia la nuova chiave immediatamente

Invalidazione Immediata

La rigenerazione invalida istantaneamente la vecchia chiave. Aggiorna tutte le integrazioni prima di rigenerare.

Eliminare Chiave

Rimuovi permanentemente una chiave:

1. Clicca Elimina
2. Conferma l'azione
3. La chiave viene rimossa permanentemente

Formato Chiave API

Le chiavi seguono questo formato:

vsk_[environment]_[random-string]

Prefisso	Ambiente
vsk_live_	Produzione
vsk_test_	Testing

Best Practice Sicurezza

Conservazione Chiavi

• Conserva in variabili d'ambiente
• Usa sistemi di gestione secret
• Non committare mai nel version control
• Non includere nel codice client-side

Rotazione Chiavi

• Ruota le chiavi periodicamente
• Ruota immediatamente se compromesse
• Usa chiavi a breve durata per testing

Controllo Accessi

• Crea chiavi separate per integrazione
• Usa nomi descrittivi
• Monitora l'utilizzo chiavi
• Disattiva chiavi non usate

Cosa NON Fare

• Condividere chiavi nelle email
• Pubblicare chiavi in chat/Slack
• Includere negli URL
• Conservare in file di testo semplice

Rate Limiting

Le richieste API sono soggette a limiti:

Limite	Valore
Per minuto	60 richieste
Per ora	1.000 richieste

Header Rate Limit

Le risposte includono:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1609459200

Limite Superato

Quando superato:

• Risposta HTTP 429
• Riprova dopo il tempo indicato
• Implementa backoff esponenziale

Risoluzione Problemi

401 Unauthorized

Cause:

• Chiave API non valida
• Chiave disattivata
• Chiave eliminata/rigenerata
• Header mancante

Soluzioni:

1. Verifica che la chiave sia corretta
2. Controlla che la chiave sia attiva
3. Rigenera se necessario

403 Forbidden

Cause:

• La chiave non ha i permessi
• Funzionalità non nel piano
• Restrizioni workspace

Soluzioni:

1. Controlla funzionalità piano
2. Verifica proprietà chiave
3. Contatta supporto

Chiave Non Visualizzata

Se hai perso la chiave:

1. L'originale non può essere recuperata
2. Rigenera per ottenerne una nuova
3. Aggiorna tutte le integrazioni

Limiti Chiavi

Per Piano

Piano	Max Chiavi API
Professional	5 chiavi
Enterprise	Illimitate

Raccomandazioni

• Produzione: 1 chiave per integrazione
• Sviluppo: Chiavi testing separate
• CI/CD: Chiave deployment dedicata

Pagine Correlate

• Riferimento API - Documentazione API completa
• Webhook - Notifiche real-time
• Integrazioni - Integrazioni pre-costruite