Tutte le guide

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

  1. Vada in Impostazioni → Token API e selezioni Nuovo token.
  2. Inserisca un Nome che indichi a che cosa serve il token, per esempio "Esportazione fatture contabilità".
  3. Scelga le Autorizzazioni: Utente (Sue sorgenti, destinazioni e lavori), Amministratore o Proprietario, al massimo il Suo ruolo.
  4. Scelga la Scadenza: 7, 30 o 90 giorni, 1 anno, una data personalizzata o nessuna scadenza.
  5. 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