Marche Temporali InfoCert

L'API Marche Temporali permette di marcare documenti o acquistare lotti ai prezzi più bassi del mercato. Non ci sono obblighi minimi di acquisto.

Openapi è l'unica piattaforma che consente di acquistare lotti di marche erogati da 2 differenti Enti Certificatori accreditati (Time-Stamping Authority - TSA): InfoCert e Aruba.

In particolare l'API consente di:

Marche temporali InfoCert

Le marche temporali InfoCert hanno validità europea secondo quanto stabilito dal Regolamento eIDAS. Possono essere utilizzate autonomamente, ad esempio integrate in un software, o insieme a qualsiasi dispositivo di Firma digitale.

Attualmente i lotti di marche temporali InfoCert disponibili sono da:

È possibile verificare il costo dei singoli lotti nella sezione dedicata sotto l'endpoint GET /marche

La procedura di marcatura o rilascio lotti di marche temporali è immediata.

Verifica disponibilità del lotto di marche InfoCert desiderato

GET /availability/{type}/{qty}

Il service consente di verificare quali lotti di marche temporali, InfoCert o Aruba, sono disponibili per l'acquisto.

ESEMPIO CHIAMATA

È possibile effettuare la chiamata a partire dai parametri 'type', ovvero nome dell'ente certificatore (InfoCert o Aruba), e 'qty', ovvero quantità, cioè numero di marche del lotto (es. 100, 1000):

GET https://ws.marchetemporali.com/avalability/infocert/100

In questo caso stiamo verificando la disponibilità del lotto da 100 di marche temporali InfoCert.

ESEMPIO RISPOSTA

Nella risposta sarà presente il numero di lotti disponibili:

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

Una volta accertata la disponibilità, è possibile procedere all'acquisto con l'endpoint dedicato.

Acquisto del lotto di Marche Temporali

GET /marche/{type}/{qty}

Tramite il service Marche Temporali è possibile acquistare un lotto di marche temporali, scegliendo come anticipato tra InfoCert e Aruba. L'endpoint da utilizzare è GET /marche/{type}/{qty} .

ESEMPIO CHIAMATA

La chiamata può essere effettuata a partire dai parametri 'type', ovvero tipo di marca, e 'qty' ovvero quantità.

GET https://ws.marchetemporali.com/marche/infocert/100

ESEMPIO RISPOSTA

La risposta fornirà i dettagli del lotto di marche appena acquistato, in particolare username e password.

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

Una volta ottenute le credenziali sarà possibile iniziare a marcare i documenti digitali con:

Verifica delle marche utilizzate

POST/check_lotto

È possibile in qualsiasi momento verificare il numero di marche ancora disponibili del lotto acquistato tramite l'endpoint POST/check_lotto

ESEMPIO CHIAMATA

Nel body della chiamata POST/check_lotto dovranno essere passati i valori 'username' e 'password' del lotto di cui si vogliono verificare le marche residue:

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

ESEMPIO RISPOSTA

La risposta, come anticipato, indica il numero di marche ancora disponibili e la quantità già utilizzata:

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

Elenco lotti di marche acquistati

GET /marche

L'endpoint GET/marche consente di verificare la lista di tutte le marche acquistate tramite account Openapi ed ottenere tutti i dati associati come ad esempio username e password.

ESEMPIO CHIAMATA

GET https://ws.marchetemporali.com/marche

L'endpoint è utile perché permette di ottenere i dati da utilizzare poi in fase di marcatura temporale con lotto proprio. Non è necessario alcun parametro per questa chiamata.

ESEMPIO RISPOSTA

La risposta fornisce i dettagli del lotto di marche selezionato: l'ID e nome Ente Certificatore Accreditato (InfoCert o Aruba), la quantità (es. 50), l'username e password scelti, l'id entità e infine la data e l'orario esatti di acquisto.

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

Il service è già stato scelto da centinaia di aziende ed integrato in software di contabilità, piattaforme per la tutela dei diritti di autore, di gestione del credito, valutazioni rischi e di monitoraggio procedure aziendali.