Certificate - put
Endpoint per il caricamento di un certificato. Questo endpoint funziona in due modalità a seconda dei parametri passati: tramite hash o tramite file.
Last updated
Endpoint per il caricamento di un certificato. Questo endpoint funziona in due modalità a seconda dei parametri passati: tramite hash o tramite file.
Last updated
PUT https://public-api.timesafe.io/certificate/put
Questo servizio permette di salvare un hash in blockchain. Se in modalità sandbox il certificato sarà confermato entro 60 secondi, ma i dati relativi al salvataggio in blockchain saranno dei fac-simile. Se in modalità live, può essere necessario un tempo fino a 7 minuti per avere conferma completa di salvataggio in blockchain per Ethereum, fino a 3 minuti per Algorand. Questi tempi si riferiscono a un normale stato operativo delle blockchain, in eccezionali casi di grande congestione delle blockchain relative, possono subire variazioni.
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
POST https://public-api.timesafe.io/certificate/put
Questo servizio permette di salvare un hash in blockchain partendo da un file che viene a sua volta salvato in un apposito storage remoto e non pubblico. Se in modalità sandbox il certificato sarà confermato entro 60 secondi, ma i dati relativi al salvataggio in blockchain saranno dei fac-simile. Se in modalità live, può essere necessario un tempo fino a 7 minuti per avere conferma completa di salvataggio in blockchain.
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
token
string
Token JWT ottenuto da endpoint di login
blockchain
string
Indica quale blockchain usare. Può valere "Algorand" o "Ethereum". Opzionale, di default vale "Ethereum".
hash_file_and_cf
boolean
Indica se l'hash passato è da salvare in blockchain così come è (0) o se deve prima essere giustapposto all'hash del Codice Fiscale dell'utente (1). Opzionale, di default vale 1.
note
string
campo libero per le note (o dati custom che si vogliono persistere)
fileSize
integer
dimensione del file originale, in Byte.
fileName
string
Nome del file originale. Di fatto può essere un identificativo diverso dal nome del file, ma si suggerisce di usare il nome orginale e usare il campo note per altri scopi.
url
string
se il file è presente in uno storage pubblico raggiungibile tramite URL si può inserire qui il suo indirizzo
parent
integer
se questo certificato è una nuova versione di uno già presente, specificare con questo parametro l'ID. NOTA: il parent deve essere della stessa modalità (live/sandbox) dell'utenza in uso.
hash
string
Hash del file ottenuto con algoritmo SHA1, senza 0x iniziale
token
string
Token JWT ottenuto da endpoint di login
blockchain
string
Indica quale blockchain usare. Può valere "Algorand" o "Ethereum". Opzionale, di default vale "Ethereum".
hash_file_and_cf
boolean
indica se l'hash passato è da salvare in blockchain cos' com'è (0) o se deve prima essere giustapposto all'hash del Codice Fiscale (1). Opzionale, di default vale 1.
note
string
Campo libero per le note (o parametri custom che si vogliono persistere)
parent
integer
se questo certificato è una nuova versione di uno già presente, specificare con questo parametro l'ID . NOTA: il parent deve essere della stessa modalità (live/sandbox) dell'utenza in uso.
file
object
Il file da salvare.