Kandji API

¿Qué es el API de Kandji ?

El API de Kandji es una herramienta sólida diseñada para ayudarte a administrar y proteger los dispositivos Apple dentro de tu organización. Le permite automatizar tareas, integrarse con otros servicios y mejorar las capacidades de Kandji más allá de la interfaz de usuario.

Generar un token de API

Para cada caso de uso específico, es mejor crear un token de API único. Para identificarlos fácilmente, considere la posibilidad de asignar nombres claros y descriptivos dentro de la aplicación web Kandji .

Kandji usa tokens de portador de nivel de inquilino para controlar el acceso a la API. Para generar uno:

  1. Inicie sesión y haga clic en Configuración.

  2. Haga clic en la pestaña Acceso .

  3. Haga clic en el botón Agregar token de API para crear una nueva clave de API. 

  4. Proporcione un nombre y una descripción para el token de API.

  5. Haga clic en Crear. 

  6. Kandji mostrará un modal con el token de API. Haga clic en el símbolo de visibilidad para exponerlo o use el botón Copiar token para copiar el token de API en el portapapeles, almacenándolo en un lugar seguro. Nota: No podrás volver a ver los detalles del token.

  7. Haga clic en Siguiente.

  8. Haga clic en Configurar para administrar los permisos de API para este token específico o en Omitir para cambiarlos más adelante. 

  9. Después de realizar las modificaciones, haga clic en Guardar.

  10. Una vez que cree el primer token, verá la dirección URL de la API específica del inquilino.

Inspeccionar, modificar o revocar un token de API

Si quita a un usuario administrador de la aplicación web de Kandji después de que haya creado un token de API, también se quitará el token de API.

Después de crear un token de API para el inquilino, puede modificar su nombre y permisos o revocarlo para evitar un mayor acceso. 

Inspeccionar o modificar un token

  1. Haga clic en los puntos suspensivos verticales junto al token. 

  2. Haga clic en Ver para mostrar información sobre el token, incluidos los permisos asociados al token. Desde esta página, puede utilizar las siguientes opciones.

    1. Haga clic en la pestaña Permisos para editar los permisos asociados con el token. 

    2. Haga clic en la pestaña Actividad para ver la actividad del token de API, lo que incluye:

      • Token creado

      • Nombre del token cambiado

      • Permisos de token editados

Revocar un token

  1. En la esquina inferior derecha, haz clic en Editar para editar el nombre del token.

  2. Haga clic en Revocar para invalidar el token de API y evitar su uso posterior. Si revoca un token, ya no lo verá en la lista de tokens de API para el inquilino. 

Documentación de la API

La documentación completa de los puntos finales de la API está disponible en api-docs.kandji.io. En este artículo se explica cómo generar un token de API dentro del inquilino Kandji .

Límite de velocidad de API

La API de Kandji tiene actualmente un límite de tasa de API de 10.000 solicitudes por hora por inquilino.