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.
TimeSafe API Clienti.postman_collection.json
8KB
Code
TimeSafe API Client.postman.collection.json
TimeSafe Public API.postman_environment.json
418B
Code
TimeSafe Public API.postman_environment.json
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)

Next - API

User

Last modified 2yr ago

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.

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.