| Suite | Team, Growth, Professional, Enterprise o Enterprise Plus |
| Support | Team, Professional o Enterprise |
Resumen de IA verificado ◀▼
Administre el acceso de API a su cuenta de Zendesk mediante la generación, edición, desactivación, reactivación y eliminación de los tokens de API. En los planes Enterprise, visualice el registro de auditoría para las actividades de tokens.
Los usuarios pueden usar un token de API para autenticar las solicitudes de API. Los tokens de API son contraseñas generadas automáticamente que se pueden usar con su dirección de correo electrónico para autenticar las solicitudes de API. También se pueden usar como parte de la autenticación de dos factores para las integraciones. Cada token de API puede ser usado por cualquier usuario verificado en la cuenta y no está asociado con ningún usuario en particular. Puede haber más de un token activo a la vez.
Se pueden tener hasta 256 tokens. Si ya alcanzó ese límite, debe borrar un token existente para poder agregar uno nuevo. Las cuentas que actualmente cuentan con más de 256 tokens tienen un límite de 2048 tokens.
Los tokens de API no son lo mismo que los tokens de acceso de OAuth. Consulte Differences between API tokens and access tokens (Diferencias entre los tokens de API y los tokens de acceso) en developer.zendesk.com.
Este artículo contiene las siguientes secciones:
Generar tokens de API
Para generar un token de API, debe ser un administrador y el acceso con token de API tiene que estar activado en su cuenta.
Para generar un token de API
-
En el Centro de administración, haga clic en
Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
Aparece una lista de tokens de API.
- Haga clic en Agregar token de API.
- (Opcional) Ingrese una Descripción para el token.
- Haga clic en Guardar para generar el token.
El token se genera y se muestra.
-
Copie el token y péguelo en un lugar seguro.
Nota: Cuando haga clic en Guardar para cerrar esta ventana, no se volverá a mostrar el token completo.
- Vuelva a hacer clic en Guardar para volver a la lista de tokens de API de Zendesk.
Si hace clic en el token para volver a abrirlo, se mostrará una versión truncada del token.
Editar un token de API
Puede editar un token de API para actualizar la descripción del token.
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
- Ubique el token que desee editar.
- Haga clic en el icono del menú de opciones (
) junto al token y seleccione Editar. - Ingrese una nueva Descripción para el token y luego haga clic en Guardar.
Desactivar y reactivar un token de API
En algunos casos, puede que quiera desactivar un token temporalmente para asegurarse de que no haya sido comprometido, o quizás desee desactivar un token para investigar cómo se está usando sin necesidad de borrarlo. Los tokens desactivados pueden reactivarse.
Para desactivar un token de API
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
- Ubique el token que desea desactivar.
- Haga clic en el icono del menú de opciones () junto al token y seleccione Desactivar.
- En el cuadro de diálogo de confirmación, seleccione Desactivar.
El estado del token cambia de inmediato. En cuanto se desactive el token, comenzarán a fallar las llamadas de API que lo usan.
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
- Ubique el token que desea reactivar.
- Haga clic en el icono del menú de opciones () junto al token y seleccione Reactivar.
- En el cuadro de diálogo de confirmación, haga clic en Reactivar.
El estado del token cambia de Desactivado a Activo. Si se reactiva un token, se restaura su capacidad para autenticar las solicitudes de API.
Borrar un token de API
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
- Ubique el token que desea borrar y asegúrese de que el estado sea Desactivado.
- Haga clic en el icono del menú de opciones () junto al token y seleccione Borrar.
- En el cuadro de diálogo de confirmación, haga clic en Borrar.
Visualizar los registros de auditoría para un token de API (Enterprise)
En los planes Enterprise, el registro de auditoría registra la actividad asociada con un token de API, como cuándo fue creado, desactivado o reactivado.
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > Tokens de API.
- Ubique el token en la lista.
- Haga clic en el icono del menú de opciones () junto al token y seleccione Ver registro de auditoría.
El registro de auditoría se abre con un filtro aplicado para el token de API seleccionado y muestra las actividades asociadas con el token.
25 comentarios
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
Iniciar sesión para dejar un comentario.