Idempotenza dell'API

Ogni richiesta che non sia GET necessita di un header Idempotency-Key. Utilizza una chiave stabile per ogni scrittura logica in modo che i nuovi tentativi di rete siano sicuri.

Ultimo aggiornamento - 5 giugno 2026 Tempo di lettura - 4 min Autore - Tom Rushmore

Obbligatorio per le scritture

Invia Idempotency-Key in ogni richiesta POST, PUT, PATCH e DELETE. Le chiavi mancanti restituiscono 400 idempotency_key_required.

Idempotency-Key: order-5501234567890-assignment-1

Comportamento del replay

Stessa chiave, stesso endpoint, stesso body: l'API ripropone la risposta riuscita e non scrive di nuovo.
Stessa chiave con un body diverso: l'API restituisce 409 idempotency_conflict.
Stessa chiave mentre la prima richiesta è ancora in esecuzione: l'API restituisce 409 idempotency_conflict_in_progress.
Le chiavi scadono dopo 24 ore. Genera una nuova chiave per ogni nuova operazione logica.

Documentazione API

Inizia qui

Quickstart API

Esegui un ping all'API, importa un asset, mappalo a un prodotto e assegna l'accesso a un ordine.

Riferimento

Riferimento degli endpoint

Consulta gli endpoint disponibili per asset, mappature, ordini, modifiche di accesso e stato.

È stato utile?

Ancora bloccato? Scrivi a admin@alvaapps.com.

Ultimo aggiornamento 2026-06-05