Équipe et administration
Jetons d’API
Permettez à des programmes, des scripts et des automatisations de gérer Sealed Print avec un jeton d’API.
Un jeton d’API donne à un programme l’accès à la REST API de Sealed Print, par exemple pour suivre des tâches, gérer des destinations ou lire la file d’attente depuis un script. Un jeton agit au nom de la personne qui l’a créé, avec au plus ses autorisations, et uniquement dans l’organisation où il a été créé. La référence de l’API décrit chaque point de terminaison avec des exemples.
Prérequis
- Chaque membre peut créer des jetons dans une session de navigateur. Les administrateurs voient tous les jetons de l’organisation et peuvent les révoquer.
- Les jetons gèrent et pilotent Sealed Print : tâches, sources, destinations et paramètres. Ils ne peuvent pas envoyer de tâches ; les programmes envoient plutôt les documents à un point de terminaison API.
- Inclus dans toutes les offres.
Configuration initiale
- Allez dans Paramètres → Jetons d’API et sélectionnez Nouveau jeton.
- Saisissez un Nom qui indique à quoi sert le jeton, par exemple « Export des factures comptabilité ».
- Choisissez les Autorisations : Utilisateur (vos propres sources, destinations et tâches), Administrateur ou Propriétaire, au plus votre propre rôle.
- Choisissez l’Expiration : 7, 30 ou 90 jours, 1 an, une date personnalisée ou sans expiration.
- Sélectionnez Créer et copiez le jeton. Il n’est affiché qu’une seule fois, maintenant ; conservez-le en lieu sûr, par exemple dans un gestionnaire de mots de passe.
Envoyez le jeton avec chaque requête dans l’en-tête Authorization: Bearer sp_api_…. Pour lister vos tâches :
curl "https://www.sealedprint.com/api/jobs" \
-H "Authorization: Bearer sp_api_…"
Avec le même en-tête, votre programme suit une tâche (GET /api/jobs/{id}), l’envoie à d’autres destinations ou
l’annule.
À chaque fois
- Dernière utilisation, dans la liste des jetons, indique si un programme utilise encore le jeton.
- Renommer modifie le nom ; Renouveler émet un nouveau secret pour le même jeton (l’ancien cesse immédiatement de fonctionner ; le nom, les autorisations et l’expiration sont conservés) ; Révoquer y met fin définitivement.
- Afficher les jetons expirés et révoqués liste les jetons qui ne fonctionnent plus.
Dépannage
- HTTP 401 : le jeton est manquant, erroné, expiré ou révoqué.
- HTTP 403 : les autorisations du jeton ne permettent pas l’action. Envoyer une tâche avec un jeton n’est pas
possible (code
api_endpoint_required) ; envoyez le document à un point de terminaison API. - Un jeton cesse soudain de fonctionner : les jetons deviennent invalides lorsque la personne qui les a créés quitte l’organisation. Créez un nouveau jeton avec un autre membre.
- Le jeton a été copié là où il ne devait pas l’être : sélectionnez immédiatement Renouveler ou Révoquer.
Et ensuite
- Référence de l’API : chaque point de terminaison, avec la description OpenAPI.
- Points de terminaison API
- Canaux d’entrée et de sortie