Time Stamping

  1. Home
  2. API Library
  3. Time Stamping
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.

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.
Read more on oauth API Manage my tokens


API docs by Redocly

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": [
    ],
  • "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": {
    },
  • "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": {
    },
  • "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": {
    },
  • "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
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "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

Response samples

Content type
application/json
{
  • "data": {
    },
  • "message": "Documento Verificato Correttamente",
  • "success": true,
  • "error": null
}
Web Service Revision: 2.0.0