Suite | Team, Growth, Professional, Enterprise, or Enterprise Plus |
Support | Team, Professional, or Enterprise |
Riepilogo AI verificato ◀▼
Gestisci l'accesso tramite API al tuo account Zendesk generando, modificando, disattivando, riattivando ed eliminando i token API. Con i piani Enterprise, visualizza il registro di verifica per le attività dei token.
Gli utenti possono usare un token API per autenticare le richieste API. I token API sono password generate automaticamente che puoi usare con il tuo indirizzo email per autenticare le richieste API. Possono anche essere utilizzati come parte dell’autenticazione a due fattori per le integrazioni. Ogni token API può essere usato da qualsiasi utente verificato nell’account e non è associato a un utente specifico. Possono esserci più token attivi contemporaneamente
È possibile avere fino a 256 token. Se hai raggiunto il limite, devi eliminare un token esistente per aggiungerne uno nuovo. Gli account che attualmente hanno più di 256 token hanno un limite di 2048 token.
I token API sono diversi dai token di accesso OAuth. Consulta Differenze tra token API e token di accesso su developer.zendesk.com.
Questo articolo include le seguenti sezioni:
Generazione di token API
Per generare un token API, devi essere un amministratore e l'accesso al token API deve essere attivato nel tuo account.
Per generare un token API
-
Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
Viene visualizzato un elenco di token API.
- Fai clic su Aggiungi token API.
- (Facoltativo) Inserisci una descrizione per il token.
- Fai clic su Salva per generare il token.
Il token viene generato e visualizzato.
-
Copia il token e incollalo in un luogo sicuro.
Nota: Quando fai clic su Salva per chiudere questa finestra, il token completo non verrà mai più visualizzato.
- Fai di nuovo clic su Salva per tornare all'elenco dei token API Zendesk.
Se fai clic sul token per riaprirlo, viene visualizzata una versione troncata dello stesso.
Modifica di un token API
Puoi modificare un token API per aggiornare la descrizione del token.
- Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
- Individua il token da modificare.
- Fai clic sull’icona del menu delle opzioni (
) accanto al token e seleziona Modifica.
- Inserisci una nuova descrizione per il token, quindi fai clic su Salva.
Disattivazione e riattivazione di un token API
In certe situazioni, può essere utile disattivare temporaneamente un token per verificare che non sia stato compromesso, oppure per monitorarne l'uso senza eliminarlo. I token disattivati possono essere riattivati.
Per disattivare un token API
- Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
- Individua il token da disattivare.
- Fai clic sull’icona del menu delle opzioni (
) accanto al token e seleziona Disattiva.
- Nella finestra di dialogo di conferma, seleziona Disattiva.
Lo stato del token cambia immediatamente. Non appena disattivi un token, le chiamate API che lo utilizzano smettono di funzionare.
- Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
- Individua il token da riattivare.
- Fai clic sull’icona del menu delle opzioni (
) accanto al token e seleziona Riattiva.
- Nella finestra di dialogo di conferma, fai clic su Riattiva.
Lo stato del token passa da Disattivato ad Attivo. La riattivazione di un token ne ripristina la capacità di autenticare le richieste API.
Eliminazione di un token API
- Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
- Individua il token da eliminare e assicurati che sia in stato Disattivato.
- Fai clic sull’icona del menu delle opzioni (
) accanto al token e seleziona Elimina.
- Nella finestra di dialogo di conferma, fai clic su Elimina.
Visualizzazione dei registri di verifica per un token API (Enterprise)
Nei piani Enterprise, il registro di verifica tiene traccia delle attività associate a un token API, incluse la creazione, la disattivazione e la riattivazione.
- Nel Centro amministrativo, fai clic su App e integrazioni
nella barra laterale, quindi seleziona API > Token API.
- Individua il token nell’elenco.
- Fai clic sull'icona del menu delle opzioni (
) accanto al token e seleziona Visualizza registro di verifica.
Il registro di verifica si apre con un filtro applicato per il token API selezionato. Il registro di verifica mostra le attività associate al token.
25 commenti
Sid Bhambhani
I know this is an older thread, but just wanted to share with the community in case anyone's still looking for a solution to restricting the API permissions - https://www.unevu.com/ provides a good solution for this by means of defining rules for which endpoints can be access, and even which fields should be available on a particular endpoint.
0
Alejandro Sánchez
Hola,
No me aparece la opción de API pese a tener la suscripción Team en Aplicaciones e integraciones.
Me aparecen solo Integraciones (logs e integraciones) y Conexiones (Conexiones y Clientes OAuth).
0
Audrey Ann Cipriano
Hi Charles Eljay Cruz welcome to our Community!
You and your team may follow our guide here :)
Making requests to API
List Tickets
0
Charles Eljay Cruz
Hello. Our Information Security team plan to enable the Zendesk API to integrate external application. How can we accomplish this? Thank you!
0
SUbodh Singh
Hi Team,
I'm integrating Zendesk in my tool/application where we need the OAuth 2.0 process for authorization, I have gone through the official documentation of API reference for the same, but facing an issue.
Issue:
I have created an account on Zendesk and created the Oauth Client APP. when we are authorized with the same account it works fine. when we authorize another Zendesk account then it's not working getting an error (Invalid Authorization Request No such client)
here is URL for the reference:
https://{subdomain}.zendesk.com/oauth/authorizations/new?response_type=code&redirect_uri=http://localhost:49417/listen/zendesk&client_id=Cloudsocial_zendesk&scope=read+write
If possible, let's us help to connect with developers for a quick call.
1
Jed Hollander
Ivan Miquiabas thank you for confirming.
0
Ivan Miquiabas
Thanks for reaching out!
While we do know that having access to API can only be by an administrator as per this article you can actually restrict them on Explore access via the Custom roles, so that even though users has access to API, you still do have control on accessing certain reports in your Zendesk account.
Hope that helps!
0
Jed Hollander
Was this ever answered?
I want to give someone API Access to work on an integration but I do not want them to have access to reporting. Is this possible?
Thanks.
0
Joyce
Generating an API token can be done within Apps and integrations > APIs > Zendesk API in the Admin Center. Only the OAuth access tokens can be created via API. You check this article for more information: Creating and using OAuth access tokens with the API
0
rahul siddu
hi,
is it possible to generate a new api - token through API, using zendesk access token?
0
Accedi per lasciare un commento.