Creare e gestire chiavi API

Le chiavi API vi permettono di interagire con Middlewr in modo programmatico: creare link, consultare le analytics o gestire il vostro spazio di lavoro tramite l'API. Ogni chiave ha un livello di permessi che determina a cosa può accedere. Questa guida copre la creazione, l'utilizzo e l'eliminazione delle chiavi API.

Prerequisiti

• Un account Middlewr
• Il ruolo di Admin nello spazio di lavoro (la gestione delle chiavi API è riservata agli amministratori)

Passaggio 1: Accedere alle chiavi API

Andate su Impostazioni dalla barra laterale, poi cliccate sulla scheda Chiavi API. Questa pagina elenca tutte le chiavi API esistenti dello spazio di lavoro, mostrando nome, prefisso, livello di permessi, data di ultimo utilizzo e data di creazione.

Se non esistono ancora chiavi, vedrete uno stato vuoto che vi invita a creare la prima.

Passaggio 2: Creare una chiave API

Cliccate su Crea chiave API. Apparirà una finestra modale con due campi:

1. Nome — un'etichetta descrittiva per identificare questa chiave (ad esempio "Pipeline CI/CD", "Automazione Marketing").
2. Permessi — selezionate il livello di permessi per questa chiave dal menu a tendina. I livelli disponibili dipendono dal vostro ruolo: potete assegnare solo permessi uguali o inferiori ai vostri.

Cliccate su Crea per generare la chiave.

Passaggio 3: Copiare la chiave

Dopo la creazione, una finestra di dialogo mostra la vostra chiave API completa. Questa è l'unica volta in cui la chiave viene mostrata — copiatela immediatamente e conservatela in un luogo sicuro (un gestore di segreti, una variabile d'ambiente, ecc.).

Il prefisso della chiave (primi caratteri seguiti da ...) resterà visibile nella tabella per l'identificazione, ma la chiave completa non potrà più essere recuperata.

Eliminare una chiave API

Per rimuovere una chiave, cliccate sul pulsante di eliminazione accanto ad essa nella tabella. Una finestra di conferma vi chiederà di validare, avvisandovi che qualsiasi applicazione che utilizza questa chiave perderà immediatamente l'accesso. Questa azione è irreversibile.

Best practice di sicurezza

• Una chiave per integrazione — non condividete una stessa chiave tra più servizi. Se una viene compromessa, potete revocarla senza impattare le altre.
• Permessi minimi — assegnate a ogni chiave solo il livello di accesso di cui ha effettivamente bisogno.
• Monitorate l'utilizzo — la colonna "Ultimo utilizzo" vi aiuta a individuare le chiavi inattive da eliminare.
• Ruotate regolarmente — create una nuova chiave, aggiornate la vostra integrazione, poi eliminate quella vecchia.

Per approfondire

Ora che le vostre chiavi API sono configurate, ecco alcune funzionalità da esplorare:

• Importare ed esportare link via CSV — gestite i link in blocco importando da o esportando in file CSV, che si abbina bene ai flussi di lavoro basati su API.
• Gestire fatturazione e piani — aggiornate il vostro spazio di lavoro per sbloccare limiti di rate API più alti e funzionalità aggiuntive man mano che il vostro utilizzo cresce.
• A/B testing con split routing — combinate la creazione di link via API con lo split routing per automatizzare i vostri flussi di lavoro di A/B testing.