A cosa si riferisce l'X-Idempotency-Key?
Esta página aún no está disponible en tu idioma.
L’idempotenza garantisce che richieste identiche ripetute producano lo stesso risultato, anche se vengono riproposte a causa di problemi di rete, timeout o altri problemi temporanei. Questo comportamento previene la creazione di risorse duplicate o effetti collaterali indesiderati nelle API che accettano richieste POST o PATCH.
L’intestazione HTTP X-Idempotency-Key svolge un ruolo centrale nell’implementazione dell’idempotenza. Gli integratori API utilizzano questa intestazione per identificare in modo univoco le richieste, consentendo all’API di tracciare e gestire i loro esiti attraverso i vari tentativi.
Per ulteriori informazioni, si prega di consultare la sezione dedicata all’Idempotenza nella documentazione API.
Con l’ultimo aggiornamento dell’API del 18 marzo 2026, è stato introdotto il nuovo header di risposta X-Idempotency-Replayed per tutte le richieste POST e PATCH. Questo header consente di distinguere chiaramente tra richieste ripetute ("true") e richieste elaborate come nuove ("false"), migliorando la trasparenza e semplificando le attività di debugging.
Per maggiori dettagli, consulta il nostro articolo sul blog: Unified API Update: Enhanced Idempotency Handling.
Was this page helpful?