Todas las guías

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

  1. Ve a Ajustes → Tokens de API y selecciona Nuevo token.
  2. Introduce un Nombre que indique para qué se usa el token, por ejemplo «Exportación de facturas contabilidad».
  3. Elige los Permisos: Usuario (tus propios orígenes, destinos y trabajos), Administrador o Propietario, como máximo tu propio rol.
  4. Elige la Caducidad: 7, 30 o 90 días, 1 año, una fecha personalizada o sin caducidad.
  5. 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