| 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.
1 comentario
Iniciar sesión para dejar un comentario.