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
All the knowledge you need
Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.
Get the token in the appropriate section before you start.
- 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)
This web service allows you to purchase time stamps and time stamp documents.
List of your time stamps
This method shows you the list of all purchased timestamps
Authorizations:
Responses
Response Schema: application/json
Array of objects (Marca) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "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:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "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:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "username": "J0xxxx57",
- "password": "R6xxxh5X"
Response samples
- 200
- 400
- 422
- "data": {
- "available": "250",
- "used": "0"
- "message": "DESCR = Marche per J0xxxx57; disponibili 250 consumate 0",
- "success": true,
- "error": null
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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "username": "J0xxxx51",
- "password": "5xxxxxg2",
Response samples
- 200
- 400
- 422
- "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\"}",
- "transaction": "7fc398e761e35b0c766698b27b4e7430"
- "message": "Documento Marcato Correttamente",
- "success": true,
- "error": null
Analyze the marking
This method allows you to analyze the timestamped file
Authorizations:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
Response samples
- 200
- 400
- 422
- "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