Tokens API | Procurize.AI#
Genera, gestiona y usa tokens API para acceso programático seguro a tu espacio de trabajo de Procurize.AI.
Aplica a: Panel de Control de Procurize.AI → Configuración → Tokens
Disponible en: planes Business y Enterprise
Rol requerido: Gestor de Seguridad, Editor, Administrador o Mantenedor
Visión general#
Los tokens API permiten un acceso programático seguro a la plataforma Procurize.AI. Puedes usar los tokens para integrar Procurize.AI con tus sistemas internos, automatizar flujos de trabajo o crear aplicaciones personalizadas sobre la plataforma.
Características clave:
- Los tokens heredan todos los permisos del usuario que los creó
- Los tokens son a nivel de organización – no es necesario especificar
orgen las llamadas API - Se pueden generar tokens ilimitados
- Los tokens pueden tener fechas de expiración o configurarse para que nunca expiren
- Los tokens pueden desactivarse y luego reactivarse según sea necesario
🔒 Nota de seguridad: Procurize.AI no almacena el valor del token – solo su hash. Debes copiar y guardar el token inmediatamente después de generarlo. No se mostrará nuevamente.
Accediendo al panel de gestión de tokens#
- Navega a la página Panel de Control → Tokens API.
- El panel de gestión de tokens muestra tus tokens personales asociados a la organización actual.
Permiso requerido: Solo los usuarios con roles de Gestor de Seguridad, Editor, Administrador o Mantenedor pueden acceder a este panel. Para definiciones detalladas de roles, consulta el Resumen de Permisos .
Generar un nuevo token#
Introduce un Nombre para identificar el propósito del token.
Selecciona un período de expiración:
- 1 mes
- 3 meses
- 1 año
- Sin expiración (validez ilimitada)
Haz clic en “Generar”.
Importante – Copia el token inmediatamente#
Después de la generación, el valor del token se muestra una sola vez – cópialo y guárdalo de forma segura (por ejemplo, en un gestor de contraseñas o como variable de entorno).
⚠️ No podrás volver a ver el valor del token. Procurize.AI solo almacena un hash seguro para la verificación. Si pierdes el token, deberás revocarlo y generar uno nuevo.
Gestionar tokens existentes#
El panel de Tokens muestra una lista de todos los tokens generados con su:
- Nombre
- Sufijo
- Fecha de creación
- Fecha de expiración (o “-”)
- Estado: Activo o Inactivo
Desactivar / Reactivar un token#
- Desactivar – deshabilita temporalmente el token. Puedes reactivarlo más tarde cuando lo necesites.
- Reactivar – restaura un token previamente desactivado a estado activo.
💡 La desactivación es útil para suspender integraciones temporalmente sin eliminar el token.
Revocar un token#
- Revocar – elimina permanentemente el token. Esta acción no se puede deshacer.
- Si pierdes un token, revócalo inmediatamente y genera uno nuevo.
Usar un token API#
URL base y autenticación#
| Parámetro | Valor |
|---|---|
| URL Base | https://api.procurize.com |
| Método de autenticación | Clave API mediante encabezado |
| Encabezado | X-API-Key: <TU_TOKEN_API> |
Solicitud de ejemplo (cURL)#
curl -X GET "https://api.procurize.com/v1/documents" \
-H "X-API-Key: TU_TOKEN_API"
🧠 No se necesita ID de organización – el token está vinculado a tu organización, por lo que la API resuelve el contexto automáticamente.
Reglas importantes de seguridad y uso#
| Regla | Explicación |
|---|---|
| Permisos del token | El token tiene exactamente los mismos permisos que el usuario que lo creó. Si el rol del usuario cambia, los permisos del token se actualizan en consecuencia. |
| Vinculación a la organización | Los tokens están ligados a la organización del creador. No puedes usar un token en varias organizaciones. |
| Visibilidad del token | El valor del token se muestra solo una vez. Guárdalo inmediatamente. Procurize.AI solo almacena un hash. |
| Tokens expirados | Los tokens expirados se desactivan automáticamente y no pueden usarse. Genera un nuevo token si lo necesitas. |
Solución de problemas#
| Problema | Solución |
|---|---|
| Error “Clave API inválida” | Verifica que el token esté copiado correctamente (sin espacios extra). Asegúrate de que el token siga activo y no haya expirado. |
| El token no funciona después de un cambio de rol | Los permisos del token se actualizan para coincidir con el rol actual del usuario. Si el usuario perdió permisos, el token también los pierde. |
| Token perdido | Revoca el token perdido y genera uno nuevo. |
| Limitación de velocidad | Los límites de velocidad de la API se aplican según tu plan. Revisa los encabezados X-RateLimit-* en la respuesta. |
Temas relacionados#
- Resumen de Permisos – definiciones detalladas de roles
- Planes de Precios – qué planes incluyen acceso API
- Referencia de API REST – documentación detallada de los endpoints