Come posso autenticare le richieste API?

Importante: Zendesk sta rimuovendo i token API come metodo di autenticazione. A partire dal 28 luglio 2026, i token inutilizzati verranno disattivati automaticamente. Entro il 30 aprile 2027, tutti i token API smetteranno di funzionare. Consulta Annuncio: rimozione dei token API come metodo di autenticazione per le richieste API . 

Domanda

Come posso autenticare le richieste API usando una delle API Zendesk?

Risposta

Per effettuare richieste API autenticate, devi essere un utente verificato. Per autenticare le richieste API, puoi usare l'autenticazione di base con indirizzo email e password, indirizzo email e token API oppure token di accesso OAuth.

Tutti i metodi di autenticazione impostano l’intestazione dell’autorizzazione in modo diverso. Le credenziali inviate nel payload o nell’URL non vengono elaborate. Le opzioni sono elencate di seguito:

• Autenticazione con token API
• Autenticazione con token di accesso OAuth
• Visualizzazione dell'intestazione dell'autorizzazione

Autenticazione con token API

Se usi un Token API, combina il tuo indirizzo email e il token API per generare l'intestazione di autorizzazione. Formatta la combinazione di indirizzo email e token API come aBase-64 stringa codificata. Per un esempio di formattazione dell'intestazione dell'autorizzazione, consulta il blocco di codice qui sotto.

Authorization: Basic {base-64-encoded email_address/token:api_token}

Autenticazione con token di accesso OAuth

Se usi OAuth per l’autenticazione, formatta l’intestazione dell’autorizzazione in questo modo:

Authorization: Bearer oauth_access_token

Per maggiori informazioni, consulta Uso dell’autenticazione OAuth con la tua applicazione.

Visualizzazione dell'intestazione dell'autorizzazione

Avviso: Non inviare token API attivi o di produzione, token di accesso OAuth o password dell’account a strumenti di ispezione delle richieste di terzi o contenitori di richieste esterni. L’esposizione delle credenziali attive a servizi esterni crea un rischio per la sicurezza. Usa token fittizi o fittizi durante il test delle intestazioni esternamente.

Per vedere esattamente cosa invia la tua app, usa una pagina di terzi come Pipedream , precedentemente noto come RequestBin. Confronta le intestazioni con quelle generate da un webhook usando l’autenticazione OAuth . Punta il webhook all’URL m.pipedream.net e, nella pagina Aggiungi webhook , fai clic su Prova webhook per vederlo in azione.

Dopo che la richiesta ha raggiunto il tuo requestb.in , appare come segue:

La stringa dopo Authorization: Bearer è la chiave API fornita da RequestBin nelle impostazioni dell'account in Accesso programmatico.

Se usi Python per fare richieste, imposta le intestazioni di sessione come segue.

session = requests.Session()
session.headers = {'Content-Type': 'application/json', 'Authorization': 'Basic Basic_64_encoded_code'}

Nota: monitora l’uso dell’API con il dashboard di utilizzo dell’API e verifica eventuali limiti.

Per maggiori informazioni, consulta la documentazione per gli sviluppatori: Sicurezza e autenticazione.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.