Come genero una chiave API ventic?

L'integrazione con la piattaforma ventic richiede una chiave API per autenticare le richieste. Queste chiavi sono univoche per la tua organizzazione e offrono un accesso sicuro al tuo catalogo prodotti e ai servizi commerciali.

Ecco come gestire le tue chiavi API.

1. Accedi alla dashboard sviluppatori

Accedi al tuo account ventic e naviga nella sezione Impostazioni > Sviluppatori (Settings > Developers). Lì troverai la scheda "Chiavi API" (API Keys).

2. Genera una nuova chiave

Per creare una nuova chiave:

1. Clicca sul pulsante "Crea chiave API" (Create API Key).
2. Dai alla chiave un nome descrittivo (es. "Produzione - Negozio Principale" o "Test - Mario Rossi").
3. Scegli gli ambiti di autorizzazione (Scopes). Consigliamo di concedere alle chiavi solo le autorizzazioni necessarie (principio del minimo privilegio).
4. Clicca su "Genera".

3. Archiviazione sicura della chiave

Una volta generata, la chiave ti verrà mostrata una sola volta.

• Importante: Copia la chiave e conservala in un luogo sicuro (es. in un password manager o in un vault sicuro nella tua infrastruttura).
• Nota: Per motivi di sicurezza, ventic non mostrerà nuovamente la chiave completa dopo la chiusura della finestra.

4. Utilizzo della chiave nelle richieste

Tutte le richieste all'API ventic devono includere la chiave API nell'header HTTP X-API-Key.

Esempio di utilizzo con cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: la_tua_api_key_qui" \
     -H "Accept: application/json"

5. Rotazione e cancellazione delle chiavi

Se sospetti che una chiave sia stata compromessa, devi invalidarla immediatamente.

• Nella dashboard, seleziona la chiave che desideri eliminare e clicca su "Revoca" (Revoke).
• Una volta revocata, ogni richiesta che utilizza quella chiave verrà rifiutata.
• Genera una nuova chiave e aggiorna la tua configurazione.

Migliori pratiche di sicurezza

• Non pubblicare mai chiavi API nel codice sorgente (es. su GitHub). Usa variabili d'ambiente.
• Utilizza chiavi distinte per gli ambienti di test e di produzione.
• Controlla regolarmente l'elenco delle chiavi attive e rimuovi quelle non più necessarie.

Se hai bisogno di aiuto con l'integrazione, contatta il nostro team tecnico all'indirizzo support@ventic.ai.