Chiave di idempotenza

Una chiave di idempotenza è un identificatore scelto dal client che consente a un servizio di riconoscere i tentativi ripetuti della medesima richiesta. L’obiettivo è evitare di eseguire nuovamente un’azione aziendale già effettuata. Il contratto dell’API ne stabilisce l’effetto concreto.

Riesaminare una richiesta dall’esito incerto

In un portale fittizio la connessione si interrompe dopo una richiesta di creazione ordine. Non è chiaro se l’ERP abbia già creato l’ordine. Se il servizio supporta questa protezione, il portale usa la stessa chiave per un nuovo tentativo appropriato. Una chiave nuova potrebbe avviare un’ulteriore creazione.

Rispettare le regole dell’API

Stripe descrive regole di idempotenza diverse per le API v1 e v2. L’intestazione Idempotency-Key è un esempio specifico del fornitore. Verifichi l’ambito, la conservazione e la gestione dei dati di richiesta modificati. La stessa chiave non autorizza nuovi contenuti arbitrari e, da sola, non dimostra che l’elaborazione sia terminata.

Fonti

• Stripe: Idempotent requests