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 endpoint shows you the list of all purchased timestamps

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (Marca) [ items ]
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

200
404

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 endpoint allows you to purchase time stamps.

Applying Time stamps (Marche Temporali)

To apply a time stamp to a document via the API, use the POST /marca endpoint.

Provider Compatibility

Important Note: The POST /marca endpoint is designed to work exclusively with time stamps purchased from Infocert. It is not compatible with timestamps acquired from Aruba.

Procedure for Aruba Timestamps

If you are using Aruba time stamps, you must use their dedicated tools.

ArubaSign Web Portal An online tool for applying time stamps directly in a web browser.

Link: https://arubasign.arubapec.it/asonline/

ArubaSign Desktop Software A downloadable application for managing digital signatures and timestamps on your computer.

Link: https://www.pec.it/gestione-supporto-firma-digitale.aspx

Authorizations:

bearerAuth

path Parameters

type required	string Default: "<string>" Enum: "infocert" "aruba" Example: aruba Type of time stamps
qty required	string Default: "<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

200
400
402
404
422

Content type

application/json

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

Availability of time stamps

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

Authorizations:

bearerAuth

path Parameters

type required	string Default: "<string>" Enum: "infocert" "aruba" Example: aruba Type of time stamps
qty required	string Default: "<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

200
400

Content type

application/json

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

Control over consumption

This endpoint 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 Default: "<string>" name assigned to use the time stamp batch
password required	string Default: "<string>" password assigned to use the time stamp batch
type	string Default: "<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

200
400
422

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 endpoint 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 Default: "<string>" name of the time stamp batch
password	string Default: "<string>" password of the time stamp batch
file required	string Default: "<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 Default: "<boolean>" if false returns only the timestamp on the file, if true a file in mime format containing original file and timestamp
type	string Default: "<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

200
400
422

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 endpoint allows you to analyze the timestamped file

Authorizations:

bearerAuth

Request Body schema: application/json

file	string Default: "<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

200
400
422

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
}