Suite | Team, Growth, Professional, Enterprise oder Enterprise Plus |
Support | Team, Professional oder Enterprise |
Verifizierte KI-Zusammenfassung ◀▼
Sie können den API-Zugriff auf Ihr Zendesk-Konto managen, indem Sie API-Token erstellen, bearbeiten, deaktivieren, reaktivieren und löschen. Bei Enterprise-Plänen können Sie die Token-Aktivitäten im Auditprotokoll einsehen.
Benutzer können ein API-Token verwenden, um API-Anfragen zu authentifizieren. API-Token sind automatisch generierte Kennwörter, die zusammen mit der E-Mail-Adresse verwendet werden können, um API-Anfragen zu authentifizieren. API-Token können auch für die Zwei-Faktor-Authentifizierung bei Integrationen genutzt werden. Jedes API-Token kann von jedem bestätigten Benutzer des Kontos verwendet werden; es ist nicht mit einem bestimmten Benutzer verknüpft. Es können mehrere Token gleichzeitig aktiv sein.
Sie können bis zu 256 Token einrichten. Wenn dieses Limit erreicht ist, müssen Sie ein vorhandenes Token löschen, um ein neues hinzuzufügen. Für Konten, die derzeit über mehr als 256 Token verfügen, gilt ein Limit von 2048 Token.
API-Token sind nicht das gleiche wie OAuth-Zugriffstoken. Weitere Informationen finden Sie unter Differences between API tokens and access tokens (Englisch) auf developer.zendesk.com.
Dieser Beitrag enthält die folgenden Abschnitte:
Generieren von API-Token
Um API-Token generieren zu können, müssen Sie ein Administrator sein und der API-Tokenzugriff muss in Ihrem Konto eingeschaltet sein.
So generieren Sie ein API-Token
-
Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
Eine Liste der API-Token wird angezeigt.
- Klicken Sie auf API-Token hinzufügen.
- (Optional) Geben Sie eine Beschreibung für das Token ein.
- Klicken Sie auf Speichern, um das Token zu generieren.
Das Token wird generiert und angezeigt:
-
Kopieren Sie das Token und fügen Sie es an einem sicheren Ort ein.
Hinweis: Nachdem Sie dieses Fenster durch Klicken auf Speichern geschlossen haben, wird das vollständige Token nicht wieder angezeigt.
- Klicken Sie erneut auf Speichern, um zur Liste mit den Token für die Zendesk-API zurückzukehren.
Wenn Sie auf das Token klicken, um es erneut zu öffnen, wird eine verkürzte Version des Tokens angezeigt.
Bearbeiten eines API-Tokens
Bei Bedarf können Sie ein API-Token bearbeiten, um seine Beschreibung ändern.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
- Suchen Sie das Token, das Sie bearbeiten möchten.
- Klicken Sie auf das Optionsmenü (
) neben dem Token und dann auf Bearbeiten.
- Geben Sie eine neue Beschreibung für das Token ein und klicken Sie dann auf Speichern.
Deaktivieren und Reaktivieren eines API-Tokens
Bei Bedarf können Sie ein Token vorübergehend deaktivieren, um sicherzustellen, dass es nicht kompromittiert wurde, oder permanent deaktivieren, um zu untersuchen, wie es verwendet wird, ohne es tatsächlich zu löschen. Deaktivierte Token können reaktiviert werden.
So deaktivieren Sie ein API-Token
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
- Suchen Sie das Token, das Sie deaktivieren möchten.
- Klicken Sie auf das Optionsmenü (
) neben dem Token und dann auf Deaktivieren.
- Klicken Sie im Bestätigungsdialogfeld auf Deaktivieren.
Der Status des Tokens ändern sich sofort. Sobald Sie ein Token deaktivieren, schlagen API-Aufrufe fehl, die dieses Token verwenden.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
- Suchen Sie das Token, das Sie reaktivieren möchten.
- Klicken Sie auf das Optionsmenü (
) neben dem Token und dann auf Reaktivieren.
- Klicken Sie im Bestätigungsdialogfeld auf Reaktivieren.
Der Status des Tokens ändert sich von Deaktiviert in Aktiv. Wenn Sie ein Token reaktivieren, kann es wieder zur Authentifizierung von API-Anfragen verwendet werden.
Löschen eines API-Tokens
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
- Suchen Sie das Token, das Sie löschen möchten, und stellen Sie sicher, dass sein Status Deaktiviert lautet.
- Klicken Sie auf das Optionsmenü (
) neben dem Token und dann auf Löschen.
- Klicken Sie im Bestätigungsdialogfeld auf Löschen.
Einsehen der Auditprotokolle für API-Token (Enterprise)
Bei Enterprise-Plänen werden die mit einem API-Token verbundenen Aktivitäten im Auditprotokoll aufgezeichnet, einschließlich Zeitpunkt der Erstellung, Deaktivierung oder Reaktivierung des Tokens.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Apps und Integrationen und dann auf APIs > API-Token.
- Suchen Sie das Token in der Liste.
- Klicken Sie auf das Optionsmenü (
) neben dem Token und dann auf Auditprotokoll anzeigen.
Das Auditprotokoll wird geöffnet und nach dem ausgewählten API-Token gefiltert. Sie sehen alle mit diesem Token verbundenen Aktivitäten.
25 Kommentare
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
Anmelden, um einen Kommentar zu hinterlassen.