Evidency / Blog / API e integrazione: definizioni dei concetti chiave

API e integrazione: definizioni dei concetti chiave

Tempo di lettura: 2 min

Data di modifica: 27 Settembre 2026

Nei sistemi di prova digitale (marcatura temporale, sigillo elettronico, archiviazione elettronica, registrazione degli eventi), l’API costituisce spesso il punto di collegamento tra un’applicazione aziendale e un servizio fiduciario. Essa materializza il contratto di scambio tra i sistemi (richiesta, risposta, stati di elaborazione e autenticazione) e condiziona la tracciabilità tecnica delle operazioni.

Indice

Che cos’è un’API?

Un'API (Application Programming Interface) è un'interfaccia di programmazione che consente a un software di richiamare le funzioni rese disponibili da un altro software secondo regole pubblicate (metodi, parametri, formati, codici di ritorno). Nel caso più comune (API web), tali scambi si basano sul protocollo HTTP: un client invia una richiesta, il server restituisce una risposta, con una semantica standardizzata (metodi, codici di stato, intestazioni).

Che cos’è un’API REST?

Per API REST si intende un'API web realizzata secondo lo stile architettonico REST (Representational State Transfer), descritto da Roy Fielding: le interazioni riguardano risorse identificate, gestite tramite rappresentazioni, mediante messaggi autodescrittivi, in un modello stateless (senza stato di sessione lato server nel senso REST).

In pratica, il termine “REST” viene spesso utilizzato per definire le API HTTP che strutturano i propri URL attorno alle risorse e utilizzano in modo coerente i metodi e i codici di stato HTTP.

Che cos’è un endpoint?

Un endpoint è un punto di accesso specifico di un’API: in genere una combinazione (i) di un URL (o route), (ii) di un metodo HTTP (GET, POST, ecc.) e (iii) di un comportamento previsto (parametri, schema di risposta, possibili errori). L’insieme degli endpoint costituisce l’API. La terminologia (metodi, stati) rientra nella semantica HTTP.

Che cos’è un webhook?

Un webhook è un meccanismo di notifica “push”: anziché essere il cliente a interrogare l’API per verificare se si è verificato un evento, è il server a richiamare un URL fornito dal cliente (callback) per comunicargli l’evento. In una catena di prova, il webhook viene spesso utilizzato per notificare il completamento di un’operazione (ad esempio: «token disponibile», «documento sigillato», «archiviazione completata»), il che richiede che l’invio, la ricezione e la registrazione della chiamata siano protetti.

Che cos’è il payload?

Il payload è il carico utile di un messaggio: la parte che contiene i dati aziendali trasmessi (ad esempio un JSON, un file binario o un’impronta). In HTTP, il payload è generalmente contenuto nel corpo del messaggio (message body), mentre le intestazioni (headers) descrivono, in particolare, il tipo di contenuto, la codifica, l’autenticazione, ecc.

In un sistema probatorio, l’obiettivo principale è identificare con precisione quali elementi rientrano nel payload (dati, hash, metadati) e quali invece fanno parte delle intestazioni (contesto di trasporto, sicurezza), al fine di evitare ambiguità durante una verifica.

Che cos’è l’autenticazione?

L'autenticazione è il meccanismo mediante il quale un sistema verifica che un richiedente sia effettivamente chi dichiara di essere (ad esempio tramite una chiave segreta, un certificato o un token). In HTTP, l’autenticazione si esprime in particolare tramite i campi Authorization / WWW-Authenticate e gli schemi associati.

In un’API di fiducia digitale, l’autenticazione si combina con l’autorizzazione (diritti) e la limitazione d’uso (quote, misure anti-abuso), poiché le vulnerabilità delle API derivano spesso da un controllo degli accessi applicato in modo errato o incompleto (repertorio OWASP).

Che cos’è il TLS?

Il TLS (Transport Layer Security) è il protocollo di sicurezza che consente alle applicazioni client/server di comunicare riducendo i rischi di intercettazione, alterazione e falsificazione dei messaggi sulla rete. Costituisce la base dell’HTTPS (e, di conseguenza, della maggior parte delle API web).

Il TLS di per sé non “fornisce la prova”; garantisce la sicurezza del trasporto. Il valore probatorio di un sistema si basa poi sui meccanismi applicativi (integrità degli oggetti prodotti, tracciabilità, conservazione, verifica), ma il TLS costituisce un prerequisito tecnico per limitare le contestazioni relative al canale di trasmissione.

  • Camille è Responsabile Marketing Digitale presso Evidency. Con oltre 10 anni di esperienza, è specializzata nella gestione dei contenuti e nell’acquisizione di traffico.