Idempotence de l'API

Chaque requête qui n'est pas un GET nécessite un en-tête Idempotency-Key. Utilisez une clé stable par écriture logique afin que les nouvelles tentatives réseau soient sûres.

Dernière mise à jour - 19 octobre 2026 Temps de lecture - 4 min Auteur - Tom Rushmore

Requis pour les écritures

Envoyez Idempotency-Key à chaque requête POST, PUT, PATCH et DELETE. Les clés manquantes renvoient 400 idempotency_key_required.

Idempotency-Key: order-5501234567890-assignment-1

Comportement de rejeu

Même clé, même point de terminaison, même corps : l'API rejoue la réponse réussie et n'écrit pas à nouveau.
Même clé avec un corps différent : l'API renvoie 409 idempotency_conflict.
Même clé alors que la première requête est encore en cours : l'API renvoie 409 idempotency_conflict_in_progress.
Les clés expirent après 24 heures. Générez une nouvelle clé pour chaque nouvelle opération logique.
Utilisez une Idempotency-Key neuve pour chaque simulation (dry run) : la même clé avec et sans dry_run renvoie 409 idempotency_conflict, et une simulation rejouée renvoie l'aperçu stocké.

Documentation de l'API

Commencez ici

Démarrage rapide de l'API

Pinguez l'API, importez un asset, mappez-le à un produit et attribuez l'accès à une commande.

Référence

Référence des endpoints

Passez en revue les endpoints disponibles pour les assets, les mappings, les commandes, les changements d'accès et le statut.

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez à admin@alvaapps.com.

Dernière mise à jour 2026-10-19