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

Utili consigli per iniziare con Marche Temporali

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Munisciti del token nell' apposita sezione prima di cominciare.

Una volta ottenuto, effettua chiamate ai diversi endpoint in base alle tue esigenze.

Oas file url https://console.openapi.com/oas/it/marchetemporali.openapi.json
Fork or import with Postman
Production domain ws.marchetemporali.com
Sandbox domain test.ws.marchetemporali.com
Production Scopes 6
Sandbox Scopes 6
- GET test.ws.marchetemporali.com/availability
- POST test.ws.marchetemporali.com/check_lotto
- POST test.ws.marchetemporali.com/marca
- POST test.ws.marchetemporali.com/verifica
- GET test.ws.marchetemporali.com/marche
- POST test.ws.marchetemporali.com/analisi

Marche Temporali (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Questo servizio web consente di acquistare marche temporali e documenti di marcatura temporale.

Prima volta qui? Generare un nuovo token di accesso

Marche

Richieste per l'acquisto e il controllo di marche temporali

Elenco delle marche temporali

Questo metodo mostra l'elenco di tutti i timestamp acquistati

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (Marca)
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.marchetemporali.com/marche");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type

application/json

{

"data": [
- {
  - "id_marca": "deb184df120e0487b64a2f77a4ab60c5",
  - "type": "aruba",
  - "qty_marca": "50",
  - "username": "FAKETxxxxltravia09",
  - "password": "FAKxxxB71AJHN",
  - "id_entita": "159xxx2274",
  - "timestamp_acquisto": "2020-09-10 12:04:35"
  },
- {
  - "id_marca": "79b1ab2ce4825c955ba7b99c6d1a4b5f",
  - "type": "infocert",
  - "qty_marca": "100",
  - "username": "FAKExxxR325",
  - "password": "FAKEinxxxxx2",
  - "id_entita": "159xxx2274",
  - "timestamp_acquisto": "2020-09-10 12:10:52"
  }
],
"success": true,
"message": "",
"error": null

}

Acquisto di marche temporali

Questo metodo consente di acquistare marche temporali

Authorizations:

bearerAuth

path Parameters

type required	string Enum: "infocert" "aruba" Example: aruba Tipo di marcatura temporale
qty required	string Example: 50 Quantità di marche temporali

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.marchetemporali.com/marche/%7Btype%7D/%7Bqty%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type

application/json

{

"data": {
- "id_marca": "1bab897afce17bd101c54d6011851d10",
- "username": "FAKETSxxxxravia10",
- "password": "FAKE6GxxxxSFA"
},
"message": "Marca erogata",
"success": true,
"error": null

}

Disponibilità di marche temporali

Questo metodo consente di verificare se un certo tipo di timbri è disponibile per l'acquisto.

Authorizations:

bearerAuth

path Parameters

type required	string Enum: "infocert" "aruba" Example: aruba Tipo di marcatura temporale
qty required	string Example: 50 Quantità di marche temporali

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.marchetemporali.com/availability/%7Btype%7D/%7Bqty%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type

application/json

{

"data": {
- "availability": "89"
},
"success": true,
"message": "",
"error": null

}

Controllo dei consumi

Questo metodo consente di verificare, in relazione a un lotto specifico, quanti timestamp sono stati utilizzati e quanti ne rimangono.

Authorizations:

bearerAuth

Request Body schema: application/json

username required	string nome assegnato per utilizzare il batch della marca temporale
password required	string password assegnata per l'utilizzo del batch di marcatura temporale
type	string Enum: "infocert" "aruba" marca della marca temporale; se non viene passata è 'infocert' per impostazione predefinita

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{

"username": "J0xxxx57",
"password": "R6xxxh5X"

}

Response samples

Content type

application/json

{

"data": {
- "available": "250",
- "used": "0"
},
"message": "DESCR = Marche per J0xxxx57; disponibili 250 consumate 0",
"success": true,
"error": null

}

Marcatura

Richieste di marcatura temporale, analisi e verifica dei documenti

Stampa temporale di un documento

Questo metodo consente di contrassegnare un documento nel tempo; se non si dispone dei nostri timestamp, è comunque possibile contrassegnare un documento passando solo il parametro 'file'.

Authorizations:

bearerAuth

Request Body schema: application/json

username	string nome del lotto di marcatura temporale
password	string password del lotto di marcatura temporale
file required	string file che si vuole marcare: si può passare l'url remoto del file o il contenuto codificato in base64 o sha256
mime	boolean se falso restituisce solo il timestamp del file, se vero un file in formato mime contenente file originale e timestamp
type	string Enum: "infocert" "aruba" marca della marca temporale; se non viene passata è 'infocert' per impostazione predefinita

Responses

Response Schema: application/json

	object (Marcatura)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{

"username": "J0xxxx51",
"password": "5xxxxxg2",
"file": "https://dev.ws.marchetemporali.com/test.pdf"

}

Response samples

Content type

application/json

{

"data": {
- "available": 99,
- "used": 1,
- "timestamp_header": "{\"Date\":\"Fri, 11 Sep 2020 09:27:19 GMT\",\"Server\":\"Apache\",\"X-Powered-By\":\"Application Server Infocert - marca4\",\"Set-Cookie\":\"JSESSIONID=A9FCAAAFFF1320E96F19AD43F7B590A2.marca4; Path=\\/; Secure\",\"ICTSA-UCTTime\":\"20200911092720Z\",\"ICTSA-SN\":\"428957893\",\"ICTSA-TSAName\":\"CN=ICEDTS02202009, OU=TSA, O=INFOCERT SPA, C=IT\",\"Content-Disposition\":\"attachment; filename=\\\"test.tsr\\\"\",\"Content-Type\":\"application\\/timestamp-reply; name=\\\"test.tsr\\\"\",\"Content-Length\":\"3584\"}",
- "timestamp_body": "https://dev.ws.marchetemporali.com/MARCATURE/7fc398e761e35b0c766698b27b4e7430/test.tsr",
- "transaction": "7fc398e761e35b0c766698b27b4e7430"
},
"message": "Documento Marcato Correttamente",
"success": true,
"error": null

}

Analizzare la marcatura

Questo metodo permette di analizzare il file con data e ora

Authorizations:

bearerAuth

Request Body schema: application/json

file	string file che si vuole analizzare: si può passare l'url remoto del file o il suo contenuto codificato in base64.

Responses

Response Schema: application/json

	object (VerificaAnalisi)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{

"file": "https://dev.ws.marchetemporali.com/MARCATURE/62623dd3b911198e3c67a0d836830719/test.m7m"

}

Response samples

Content type

application/json

{

"data": {
- "transaction": "691929c444e1d7d0c6c2f78d0fed3be7",
- "UTCTime": "20200911131712Z",
- "SN": "429027229",
- "TSAName": "CN=ICEDTS02202009, OU=TSA, O=INFOCERT SPA, C=IT"
},
"message": "Documento Verificato Correttamente",
"success": true,
"error": null

}

Web Service Revision: 2.0.0