Team e amministrazione
Token API
Lasci che programmi, script e automazioni gestiscano Sealed Print con un token API.
Un token API dà a un programma accesso alla REST API di Sealed Print, per esempio per seguire i lavori, gestire le destinazioni o leggere la coda da uno script. Un token agisce per conto della persona che lo ha creato, con al massimo le sue autorizzazioni, e solo nell'organizzazione in cui è stato creato. Il riferimento API descrive ogni endpoint con esempi.
Prerequisiti
- Ogni membro può creare token in una sessione del browser. Gli amministratori vedono e possono revocare tutti i token dell'organizzazione.
- I token gestiscono e controllano Sealed Print: lavori, sorgenti, destinazioni e impostazioni. I token API non possono inviare lavori; i programmi inviano invece i documenti a un endpoint API.
- Incluso in ogni piano.
Configurazione iniziale
- Vada in Impostazioni → Token API e selezioni Nuovo token.
- Inserisca un Nome che indichi a che cosa serve il token, per esempio "Esportazione fatture contabilità".
- Scelga le Autorizzazioni: Utente (Sue sorgenti, destinazioni e lavori), Amministratore o Proprietario, al massimo il Suo ruolo.
- Scelga la Scadenza: 7, 30 o 90 giorni, 1 anno, una data personalizzata o nessuna scadenza.
- Selezioni Crea e copi il token. Il token viene mostrato solo ora; lo conservi in modo sicuro, per esempio in un gestore di password.
Invii il token con ogni richiesta nell'intestazione Authorization: Bearer sp_api_…. Per elencare i Suoi lavori:
curl "https://www.sealedprint.com/api/jobs" \
-H "Authorization: Bearer sp_api_…"
Con la stessa intestazione il Suo programma segue un lavoro (GET /api/jobs/{id}), lo invia ad altre destinazioni
o lo annulla.
Ogni volta
- Ultimo utilizzo nell'elenco dei token mostra se un programma usa ancora il token.
- Rinomina cambia il nome; Rigenera emette un nuovo segreto per lo stesso token (quello vecchio smette subito di funzionare, nome, autorizzazioni e scadenza restano invariati); Revoca lo termina definitivamente.
- Mostra scaduti e revocati elenca i token che non funzionano più.
Risoluzione dei problemi
- HTTP 401: il token manca, è errato, scaduto o revocato.
- HTTP 403: le autorizzazioni del token non consentono l'azione. Non è possibile inviare un lavoro con un token
(codice
api_endpoint_required); invii il documento a un endpoint API. - Un token smette improvvisamente di funzionare: i token diventano non validi quando la persona che li ha creati lascia l'organizzazione. Crei un nuovo token con un altro membro.
- Il token è stato copiato dove non doveva: selezioni subito Rigenera o Revoca.
Prossimi passi
- Riferimento API: ogni endpoint, con la descrizione OpenAPI.
- Endpoint API
- Canali di ingresso e di uscita