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.

certificate/put

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.

Headers

NameTypeDescription

token

string

Token JWT ottenuto da endpoint di login

Request Body

NameTypeDescription

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

{
    "status": "OK",
    "data": {
        "certificate_id": 93847,
        "certificate_hash": "cea79eade58eab4a11a65b2b79705fe0746e067a"
    }
}

certificate/put

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.

Headers

NameTypeDescription

token

string

Token JWT ottenuto da endpoint di login

Request Body

NameTypeDescription

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.

{
    "status": "OK",
    "data": {
        "certificate_id": 93847,
        "certificate_hash": "cea79eade58eab4a11a65b2b79705fe0746e067a"
    }
}

Last updated