Uso de un token de acceso

Un token de acceso autoriza las solicitudes a la API de Altium 365. Debes incluirlo en cada solicitud como token de portador en el encabezado Authorization.

Los tokens de acceso se pueden obtener de dos formas:

• Directly – al crear un token de acceso de larga duración en Administración → Desarrollador

• Via exchange – al usar un token de actualización para generar un token de acceso de corta duración (que no aparecerá en Administración → Desarrollador)

El método de autorización es el mismo, independientemente de cómo se haya obtenido el token.

Encabezado de autorización

Authorization: Bearer {access-token}

Ejemplo: curl

curl -X POST https://{workspace-domain}/api/graphql/ \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ desProjects(first: 5) { nodes { id name } } }"}'

Caducidad del token

Long-lived access tokens caducan una vez transcurrido el período de validez que configuraste al crearlos (hasta 1 año). Una vez que caduquen, tendrás que crear un nuevo token en Administración → Desarrollador.

Short-lived access tokens (obtenidos mediante el intercambio de un token de actualización) caducan tras un breve período. Cuando esto ocurra, vuelve a intercambiar tu token de actualización para obtener uno nuevo; consulta Uso de un token de actualización.

Un token caducado hace que las solicitudes a la API devuelvan 401 Unauthorized, o 200 OK con el código de error AuthExpiredToken en la respuesta de GraphQL.

Seguridad

• No incluyas tokens de acceso en el código del lado del cliente ni los guardes en el sistema de control de versiones.

• Para integraciones automatizadas de larga duración, es preferible usar tokens de actualización: los tokens de acceso de corta duración limitan el período de exposición si un token se ve comprometido.

Consulta también

• Uso de un token de actualización