The Time Stamping service makes it possible to assign a certain date and time to each computer document.

In particular, the service makes it possible to:

• Purchase lots of InfoCert or Aruba timestamps
• Time stamp a document using its own lots of timestamps with tsr or m7m format
• Time stamp a document with tsr or m7m format, without having its own lot
• Check availability of remaining timestamps in a lot
• Check details, validity and correctness of a time stamped document

With Openapi it is possible to purchase lots of timestamps, provided by 2 different accredited Certification Authorities (Time-Stamping Authority - TSA): InfoCert and Aruba. The available lots are:

• InfoCert Timestamps: 100, 250, 500, 1000, 2,000, 5000, 10,000, 20,000, 50,000, 100,000, 200,000, 500,000
• Aruba Timestamps: 20, 100, 250, 500

Timestamps, both InfoCert and Aruba, have European validity according to the eIDAS Regulation and can be used independently, for example integrated in a software, or together with any Digital Signature device.

The Time Stamping service is identified by the endpoint: https://ws.marchetemporali.com

The procedure for time stamping or issuing lots is immediate.

1. List of purchased lots GET/marche

The endpoint GET https://ws.marchetemporali.com/marche allows you to check the list of all purchased timestamps via your Openapi account and obtain all associated data such as username and password.

EXAMPLE REQUEST

https://ws.marchetemporali.com/marche

The endpoint is useful because it allows you to obtain the data to be used later when time stamping with your own lot. No parameters are required for this call.

EXAMPLE RESPONSE

The response provides the details of the selected lots of marks: the ID and name of the Accredited Certification Authority (InfoCert or Aruba), the quantity (e.g. 50), the chosen username and password, the entity id and finally the exact date and time of purchase.

{
      "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
    }

2. Checking lots of time stamps available for purchase GET/availability/{type}/{qty}

This service allows you to check which lots of timestamps, InfoCert or Aruba, are available for purchase.

EXAMPLE REQUEST

The call can be made from the parameters 'type', i.e. the name of the certifying body (InfoCert or Aruba), and 'qty', i.e. the number of timestamps in the lot (e.g. 100, 1000):

https://ws.marchetemporali.com/avalability/{type}/{qty}

EXAMPLE RESPONSE

The response will contain the number of available lots:

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

3. Purchase a Lot of Time Marks GET/marche/{type}/{qty}

Through the Time stamping service it is possible to buy a timestamp's lot, choosing as mentioned above between InfoCert and Aruba. The endpoint is GET/marche/{type}/{qty}.

EXAMPLE REQUEST

The call can be made from the parameters 'type', i.e. brand type, and 'qty', i.e. quantity:

https://ws.marchetemporali.com/marche/{type}/{qty}

EXAMPLE RESPONSE

The response will provide the details of the lots of timestamping just purchased, specifically username and password.

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

4. Check used lots POST/check_lotto

It is possible at any time to check the number of timestamps still available via POST https://ws.marchetemporali.com/check_lotto

EXAMPLE REQUEST

In the body of the call POST https://ws.marchetemporali.com/check_lotto  the values 'username' and 'password' of the lots whose remaining timestamps are to be verified must be passed:

    {
      "username": "J0xxxx57",
      "password": "R6xxxh5X"
    }

EXAMPLE RESPONSE

The answer, as anticipated, indicates the number of timestamps still available and the quantity already used:

{
    "data": {
      "available": "249",
      "used": "1"
    },
    "message": "DESCR = Marche per J0xxxx57; disponibili 249 consumate 1",
    "success": true,
    "error": true
  }

5. Time Stamping POST/marca

The endpoint dedicated to time stamping is POST https://ws.marchetemporali.com/marca.

With this endpoint, it is possible to time stamp the document in two ways

• with a personal lot of time stamps (InfoCert or Aruba)
• without having any lot of time stamps

In the first case it will also be necessary to pass the username and password values of the lot that are going to be used for time stamping. In the second case, "without own lot", it will instead be necessary to pass only the url of the pdf to be time stamped.

EXAMPLE REQUEST

The call POST https://ws.marchetemporali.com/marca in the case of time stamping with its own lot will have the following values in the request body:

{
      "username": "J0xxxx51",
      "password": "5xxxxxg2",
      "file": "https://esempiourl.com/test.pdf"
    }

EXAMPLE RESPONSE

The response will provide specifications on the marked file and will also indicate how many timestamps you still have available:

{
    "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
  }

6. Document analysis POST/analisi

The service allows a time stamped document to be verified at any time.

EXAMPLE REQUEST

In the call POST https://ws.marchetemporali.com/marca the url of the file to be verified must be passed in the body:

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

EXAMPLE RESPONSE

If the time stamping process was successful, the message ('message') 'Document successfully verified' will appear in the response, otherwise you will see 'Wrong document URL or document unavailable'.

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

The service has already been chosen by hundreds of companies and integrated into accounting software, platforms for copyright protection, credit management, risk assessment and business process monitoring.