Date and time stamp any document

You will be able to validate computer documents directly through our API or purchase lots for your date attribution systems

Useful tips to start with Time Stamping

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.

Oas file url https://console.openapi.com/oas/en/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

This web service allows you to purchase time stamps and time stamp documents.

First time here? Generate a new access token

Marche

Calls for the purchase and control of time stamps

List of your time stamps

This method shows you the list of all purchased timestamps

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

}

Purchase of time stamps

This method allows you to purchase time stamps

Authorizations:

bearerAuth

path Parameters

type required	string Enum: "infocert" "aruba" Example: aruba Type of time stamps
qty required	string Example: 50 Quantity of time stamps

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

}

Availability of time stamps

This method allows you to check if a certain type of time stamps are available for purchase

Authorizations:

bearerAuth

path Parameters

type required	string Enum: "infocert" "aruba" Example: aruba Type of time stamps
qty required	string Example: 50 Quantity of time stamps

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

}

Control over consumption

This method allows you to check, in relation to a specific batch, how many timestamps you have used and how many you have left

Authorizations:

bearerAuth

Request Body schema: application/json

username required	string name assigned to use the time stamp batch
password required	string password assigned to use the time stamp batch
type	string Enum: "infocert" "aruba" brand of time stamp; if not passed it is 'infocert' by default

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

Calls for time stamping, analysis and verification of documents

Time stamp a document

This method allows you to mark a document in time; if you do not have our timestamps you can still mark a document by passing only 'file' parameter.

Authorizations:

bearerAuth

Request Body schema: application/json

username	string name of the time stamp batch
password	string password of the time stamp batch
file required	string file you want to mark: you can pass the remote url of the file or the content encoded in base64 or sha256
mime	boolean if false returns only the timestamp on the file, if true a file in mime format containing original file and timestamp
type	string Enum: "infocert" "aruba" brand of time stamp; if not passed it is 'infocert' by default

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

}

Analyze the marking

This method allows you to analyze the timestamped file

Authorizations:

bearerAuth

Request Body schema: application/json

file	string file you want to analyze: you can pass the remote url of the file or the content encoded 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