API de la cuenta de JetBrains

Con la API de JetBrains Account, puede gestionar de forma automática las licencias y recuperar los datos de uso de estas desde su JetBrains Account.

Los métodos de la API le permiten obtener información sobre las licencias, asignarlas o revocarlas y moverlas entre equipos. Su función en la JetBrains Account define qué nivel de acceso tiene a los métodos de la API. Para obtener más información, consulte la referencia de la API.

Funciones

Hay tres niveles de acceso a la API, que reflejan las funciones que tiene asignadas en el perfil de su organización. 

• Los administradores de la organización pueden habilitar y deshabilitar la API, generar y regenerar tokens para sí mismos y revocar los tokens de acceso de los usuarios de la organización, incluidos otros administradores de la organización.
• Los administradores de equipo pueden generar, regenerar y eliminar tokens de acceso para los usuarios de su equipo, incluidos los demás administradores de este equipo.
• Los espectadores y los contactos principales pueden generar, regenerar y eliminar tokens de acceso para ellos mismos. Los tokens de acceso de los espectadores y los contactos principales permiten el acceso de solo lectura a la API.

Cómo habilitar la API

Para habilitar la API, siga estos pasos. 

1. Inicie sesión en su JetBrains Account con las credenciales de administrador de la organización.
   Los administradores de equipo no pueden habilitar o deshabilitar la API.
   
2. En el menú de la izquierda, haga clic en el nombre de su organización y, después, en Administration.
3. Haga clic en Enable API.
   
   Esto hará que la API esté disponible para todos los administradores de la organización y del equipo, así como para los espectadores y los contactos principales. Todos los usuarios con funciones asignadas podrán generar tokens.

Cómo deshabilitar la API

Para deshabilitar la API, siga los pasos 1 y 2 como en el caso anterior y, a continuación, haga clic en Disable API.

Este botón deshabilita la API para todos los administradores, espectadores y contactos principales.

Cómo acceder a los métodos de la API

Para acceder a los métodos, necesita dos parámetros. 

1. El código de cliente para el parámetro X-Customer-Code

El código de cliente es un ID de organización único. Para conocer su código de cliente, vaya a su JetBrains Account y busque el número junto al nombre de su organización.

 

Pase este valor al parámetro X-Customer-Code.

 

2. El token de acceso para el parámetro X-Api-Key

Para generar el token de acceso:

1. Vaya a su JetBrains Account. 
2. En el menú de la izquierda, haga clic en el nombre de su organización o equipo y, después, en Administration.
   
3. Haga clic en Generate Token.
   
4. El token se mostrará en un cuadro de diálogo. Por cuestiones de seguridad, solo lo verá una vez. Guárdelo en un lugar seguro antes de cerrar el cuadro de diálogo. No comparta el token con nadie.
   
   Si pierde el token, tendrá que generar uno nuevo. La generación de un nuevo token invalidará el anterior.
   
   

Pase el token que ha obtenido al parámetro X-Api-Key.

Duración del token

Si deshabilita y habilita la API, el token de acceso seguirá siendo válido, a menos que genere uno nuevo de forma manual. 

Cada usuario, aunque tenga asignadas varias funciones, tiene solamente un token. El token es el mismo siempre que el usuario mantenga al menos una función. Si el usuario pierde todas las funciones, el token de acceso se revoca de forma automática.