Marche Temporali Aruba

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 ti 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 Aruba

Le marche temporali Aruba 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 Aruba 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à lotto di Marche

GET /availability/{type}/{qty}

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

ESEMPIO RICHIESTA

È 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/aruba/100

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

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 lotto di Marche

GET/marche/{type}/{qty}

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

ESEMPIO RICHIESTA

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

GET https://ws.marchetemporali.com/marche/aruba/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 RICHIESTA

Questo è un esempio di richiesta:

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: ID e nome Ente Certificatore Accreditato (InfoCert o Aruba), quantità (es. 50), username e password scelti, id entità e infine data e 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
    }

L'API Marcatura Temporale inoltre consente di procedere alla marcatura temporale tramite API con o senza proprio lotto.

Se desideri lotti di marche temporali Aruba di dimensioni più ampie puoi richiederli contattandoci tramite form dedicato.

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.