Attribuisci data e ora certa a qualsiasi documento
Potrai validare i documenti informatici direttamente tramite le nostre API o acquistare i lotti per i tuoi sistemi di attribuzione data
Attualmente sono disponibili per il servizio di marcatura tramite API (POST /marca):
- .tsr
- .m7m
Il formato di default per il servizio di marcatura è il tsr.
Per utilizzare il formato .m7m è sufficiente semplicemente passare in fase di richiesta nel payload il campo mime con valore true
E' possibile marcare qualsiasi tipologia di file con il servizio di marcatura tramite API (POST /marca).
Le marche temporali, sia InfoCert che Aruba, hanno validità europea secondo quanto stabilito dal Regolamento eIDAS e possono essere utilizzate autonomamente, ad esempio integrate in un software, o insieme a qualsiasi dispositivo di Firma digitale.
Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.
Il servizio restituisce la risposta in tempo reale.
Il costo della richiesta singola parte da 0,02€ e cambia a seconda dell’opzione scelta.
Ad esempio, il service di marcatura temporale con lotto proprio ha un costo base di 0,02€, mentre il prezzo di partenza per il service di marcatura senza lotto proprio è di 0,15€.
Gli altri prezzi dei lotti dipendono dalle dimensioni: è possibile consultare i dettagli nella sezione Prezzi, all’interno della singola API.
Per effettuare richieste all’endpoint POST /analisi vanno indicati i riferimenti del file da verificare come parametro di partenza.
Nella risposta possono apparire due tipologie di messaggi:
- "Documento verificato correttamente" se il processo di marcatura ha avuto esito positivo
- "Wrong document URL or document unavailable" se la marcatura non è andata a buon fine
In caso di documento marcato correttamente verranno anche indicate informazioni come il nome dell’ente certificatore della marca e timestamp della marcatura.
La richiesta all’endpoint POST/marca può essere effettuata a partire da parametri differenti, a seconda della modalità con cui si vuole effettuare la marcatura temporale del documento:
- con lotto di marche temporali (InfoCert o Aruba) proprio
- senza essere in possesso di alcun lotto di marche con marche InfoCert
Nel primo caso i parametri di partenza sono:
- username
- password
del lotto da utilizzare per la marcatura temporale.
Nel secondo caso il parametro di partenza è l’url del pdf da marcare.
La risposta fornirà specifiche sul file marcato e indicherà anche quante marche si hanno ancora a disposizione.
È possibile effettuare un controllo del documento con l’endpoint POST /Analisi.
Nel body della richiesta potrà essere passato:
- l'url remoto del file
- il suo contenuto codificato in base64
Con le API di Openapi è possibile marcare un documento secondo 2 modalità:
- con lotto proprio (InfoCert o Aruba)
- con lotto reso da disponibile da Openapi
In questo secondo caso la marcatura sarà effettuata con marca temporale dell’Ente Certificatore InfoCert.
La richiesta a POST/check_lotto può essere effettuata a partire dai parametri:
- username
- password
del lotto di cui si vuole verificare il numero di marche residue.
La risposta indica il numero di marche ancora disponibili e la quantità già utilizzata.
È possibile verificare lo stato di consumi tramite l’endpoint POST/check_lotto o tramite interfaccia nella sezione Utilizzo.
I lotti attualmente disponibili sono:
- Marche Temporali InfoCert: 100, 250, 500, 1000, 2.000, 5000, 10.000, 20.000, 50.000, 100.000, 200.000, 500.000
- Marche Temporali Aruba: 20, 100, 250, 500
È possibile verificare la disponibilità di ogni singolo lotto tramite l’endpoint GET /availability/{type}/{qty}.
La richiesta a GET/availability/{type}/{qty} può essere effettuata a partire dai parametri:
- ‘type’, ovvero nome dell’ente certificatore (InfoCert o Aruba)
- ‘qty’, ovvero quantità, cioè numero di marche del lotto (es. 100, 1000)
La risposta indica il numero di lotti disponibili.
La richiesta a GET/marche/{type}/{qty} può essere effettuata a partire dai parametri:
- ‘type’, ovvero nome dell’ente certificatore (InfoCert o Aruba)
- ‘qty’ ovvero quantità, cioè numero di marche del lotto (es. 100, 1000)
La risposta fornisce i dettagli del lotto di marche appena acquistato, in particolare username e password.
È possibile acquistare lotti di marche temporali di 2 Enti Certificatori accreditati (Time-Stamping Authority - TSA): InfoCert e Aruba. Le marche temporali utilizzate per la marcatura singola sono quelle di InfoCert.
Per acquistare un lotto di marche temporali è necessario effettuare una richiesta all’endpoint GET /marche/{type}/{qty} indicando tipologia (type), cioè InfoCert o Aruba, e quantitativo di marche del lotto (es. 50).
Per effettuare una richiesta a GET/marche non è necessario alcun parametro.
La risposta fornisce:
- i dettagli del lotto di marche selezionato: l’ID e nome Ente Certificatore Accreditato (InfoCert o Aruba)
- la quantità (es. 50)
- l’username e password scelti
- l’id entità
- la data e l’orario di acquisto
È possibile controllare i lotti di marche temporali acquistati tramite API con l’endpoint GET/marche.