Equipo y administración
Tokens de API
Permite que programas, scripts y automatizaciones gestionen Sealed Print con un token de API.
Un token de API da a un programa acceso a la REST API de Sealed Print, por ejemplo para seguir trabajos, gestionar destinos o leer la cola desde un script. Un token actúa en nombre de la persona que lo creó, como máximo con sus permisos, y solo en la organización en la que se creó. La referencia de la API describe cada endpoint con ejemplos.
Requisitos
- Cualquier miembro puede crear tokens en una sesión del navegador. Los administradores ven todos los tokens de la organización y pueden revocarlos.
- Los tokens gestionan y controlan Sealed Print: trabajos, orígenes, destinos y ajustes. No pueden enviar trabajos; los programas envían los documentos a un endpoint de API.
- Incluido en todos los planes.
Configuración inicial
- Ve a Ajustes → Tokens de API y selecciona Nuevo token.
- Introduce un Nombre que indique para qué se usa el token, por ejemplo «Exportación de facturas contabilidad».
- Elige los Permisos: Usuario (tus propios orígenes, destinos y trabajos), Administrador o Propietario, como máximo tu propio rol.
- Elige la Caducidad: 7, 30 o 90 días, 1 año, una fecha personalizada o sin caducidad.
- Selecciona Crear y copia el token. Solo se muestra ahora; guárdalo de forma segura, por ejemplo en un gestor de contraseñas.
Envía el token con cada solicitud en la cabecera Authorization: Bearer sp_api_…. Para listar tus trabajos:
curl "https://www.sealedprint.com/api/jobs" \
-H "Authorization: Bearer sp_api_…"
Con la misma cabecera, tu programa sigue un trabajo (GET /api/jobs/{id}), lo envía a otros destinos o lo
cancela.
Cada vez
- Último uso, en la lista de tokens, muestra si un programa sigue usando el token.
- Renombrar cambia el nombre; Renovar emite un secreto nuevo para el mismo token (el anterior deja de funcionar de inmediato; nombre, permisos y caducidad se mantienen); Revocar lo anula definitivamente.
- Mostrar caducados y revocados enumera los tokens que ya no funcionan.
Solución de problemas
- HTTP 401: falta el token, o es incorrecto, ha caducado o se ha revocado.
- HTTP 403: los permisos del token no permiten la acción. No es posible enviar un trabajo con un token
(código
api_endpoint_required); envía el documento a un endpoint de API. - Un token deja de funcionar de repente: los tokens dejan de ser válidos cuando la persona que los creó abandona la organización. Crea un token nuevo con otro miembro.
- El token se ha copiado donde no debía: selecciona Renovar o Revocar de inmediato.
Siguientes pasos
- Referencia de la API: todos los endpoints, con la descripción OpenAPI.
- Endpoints de API
- Canales de entrada y de salida