L'API di firma elettronica Certyneo in Postman
Importa la collection pubblica Certyneo in Postman e prova ogni endpoint dell'API REST v1 — creazione di buste, invio, tracciamento dello stato, webhook — con esempi di richieste già compilati.
Collection gratuita e pubblica. Una chiave API Certyneo è necessaria per eseguire le richieste.
Perché usare la collection Postman Certyneo
La collezione è pensata per gli sviluppatori che desiderano esplorare l'API Certyneo senza leggere l'intera documentazione prima di lanciare la loro prima richiesta.
Richieste pronte all'uso
Ogni endpoint dell'API REST v1 è documentato con un esempio di richiesta e di risposta, pronto per essere eseguito dopo aver inserito la tua chiave API.
Ambienti di test
Una variabile d'ambiente Postman contiene la tua chiave API e l'URL di base, per passare facilmente tra i tuoi account o ambienti.
Documentazione generata automaticamente
La documentazione Postman della collezione rimane sincronizzata con la spec OpenAPI dell'API Certyneo — nessun scarto tra ciò che testi e ciò che è in produzione.
Testare senza scrivere codice
Crea una busta, inviala e segui il suo stato direttamente dall'interfaccia Postman, ancora prima di integrare l'API nella tua applicazione.
Ciò che copre la collezione
Una panoramica dei gruppi di endpoint disponibili nella collezione pubblica.
| Gruppo | Ciò che contiene |
|---|---|
| Buste | Creare, inviare, elencare, consultare e annullare una busta di firma. |
| Documenti | Caricare un documento o importarlo da un URL (sourceUrl), consultare il suo stato. |
| Firmatari | Aggiungere destinatari, definire il loro ordine di firma e il loro livello (SES/AES). |
| Webhook | Creare e gestire gli abbonamenti agli eventi di firma. |
| Invio in massa | Inviare più buste in un'unica richiesta per campagne di firma in volume. |
La raccolta è pubblica in lettura: puoi consultarla senza account, ma l'esecuzione delle richieste richiede una chiave API Certyneo valida.
Iniziare con la raccolta in 4 passaggi
Meno di 5 minuti per lanciare la tua prima richiesta.
- 1
Importare la raccolta pubblica
Da Postman, apri la raccolta pubblica Certyneo e fai clic su « Fork » o « Import » per copiarla nel tuo spazio personale.
- 2
Generare una chiave API Certyneo
Nel tuo dashboard Certyneo, apri Impostazioni → Chiavi API e crea una chiave dedicata a Postman.
- 3
Compilare la variabile d'ambiente
Incolla la tua chiave API nella variabile d'ambiente della raccolta Postman, insieme all'URL di base dell'API.
- 4
Inviare una prima richiesta
Esegui la richiesta « Creare una busta » e segui il risultato direttamente in Postman.
Sicurezza e best practice
Le richieste della raccolta passano attraverso la stessa API della tua applicazione in produzione: si applicano le stesse regole di sicurezza.
- Tutte le richieste transita in HTTPS/TLS 1.2 minimo.
- Ogni chiave API è limitata alle autorizzazioni che le concedi al momento della creazione.
- Utilizza una chiave di test dedicata per i tuoi test Postman, distinta dalla tua chiave di produzione.
- Una chiave API compromessa o inutilizzata si revoca in un clic dal tuo dashboard Certyneo.
Domande frequenti
È necessario un piano a pagamento per utilizzare la collection Postman?
No. La collection è pubblica e gratuita. I limiti del tuo piano Certyneo (numero di buste, funzionalità) si applicano alle richieste eseguite, come per qualsiasi utilizzo dell'API.
Dove trovo la mia chiave API?
Nel tuo dashboard Certyneo, sotto Impostazioni → Chiavi API. Crea una chiave dedicata ai tuoi test Postman.
La collection è aggiornata con l'ultima versione dell'API?
Sì, la collection viene rigenerata dalle specifiche OpenAPI ufficiali dell'API Certyneo ad ogni evoluzione dell'API REST v1.
Posso testare i webhook da Postman?
Sì, la collection contiene gli endpoint per creare e elencare i tuoi abbonamenti webhook. Per ricevere gli eventi in locale, utilizza un servizio di tunnel HTTP durante i tuoi test.
L'utilizzo della collection Postman ha un costo?
No, solo il consumo dell'API stessa (creazione di buste) viene decurtato dal tuo piano, esattamente come una chiamata API classica.
Per approfondire
Testa l'API Certyneo in Postman
Collection pubblica, gratuita, sincronizzata con la nostra documentazione per sviluppatori.