Introduzione

Iniziare a usare le api pubbliche di Timesafe.io

Base path

Tutte le chiamate vengono effettuate al medesimo endpoint base

https://public-api.timesafe.io

Stati degli oggetti

Le API trattano di fatto 2 oggetti base: utenti e certificati. Ecco gli stati in cui questi oggetti possono trovarsi:

Stati User

Stato

Significato

USER_NOT_ACTIVE

Questa utenza esiste ma non può essere ancora usata.

USER_READY

Questa utenza è pronta a essere usata ma non ha un Token assegnato (utente non ha mai effettuato login)

USER_LOGGED

L'utente ha effettuato un login.

USER_SUSPENDED

Utenza sospesa

USER_DELETED

Utenza eliminata definitivamente.

Stati Certificate

Stato

Significato

JUST_CREATED

Questo certificato è stato creato da un User

SENT_TO_BLOCKCHAIN

Questo certificato è stato inviato alla Blockchain, ed è in attesa di essere inserito in un pool di mining.

TRANSACTION_CREATED

Il certificato è inserito in una transazione da un miner.

BLOCK_SECURED

Il blocco di cui fa parte la transazione è stato aggiunto alla blockchain ed ha un numero di conferme sufficiente a considerarlo immutabile.

LOST_IN_FORK

La transazione di questo certificato è su un blocco che è finito in una fork non confermata della blockchain. Verrà rimesso automaticamente in stato SENT_TO_BLOCCHAIN per essere riprocessato.

È estremamente improbabile che questo stato si verifichi.

Postman

Di seguito i file per testare le API tramite Postman e il file di environment relativo. Il file di environment va modificato (da Postman o da editor testuale), inserendo il proprio Token per effettuare le chiamate.

Sandbox mode, Live mode

Le API pubbliche di Timesafe consentono l'utilizzo di una modalità sandbox Ogni untente ha a disposizione due credenziali, quelle di produzione (live mode) e quelle di test ( sandbox mode). Il funzionamento delle API è il medesimo, ma l'utenza Sandbox non salva le transazioni in blockchain e non esaurisce mai i crediti. Inoltre per gli utenti di tipo amministratore, in sandbox mode è impossibile creare nuove utenze (la chiamata ha successo ma restituisce dati mock-up)

Last updated