Idempotency anahtarı

Idempotency anahtarı, çağıranın yan etkisi olan bir isteğe eklediği benzersiz değerdir; sunucu bu sayede aynı işlemin tekrarını tanır ve işlemi yeniden çalıştırmak yerine orijinal sonucu döner.

Seyahat API'lerinde kanonik kullanım rezervasyondur. Rezervasyon isteğinden sonra yaşanan zaman aşımı, çağıranı kör bırakır: başarılı oldu mu? Idempotency anahtarıyla çağıran aynı anahtarla tekrar dener ve kesin bir cevap alır; asla çift rezervasyon oluşmaz.

Mekanizmayı iki kural güvenli kılar. Anahtar niyet başına benzersiz olmalı, farklı bir rezervasyon için asla yeniden kullanılmamalıdır. Sunucu da aynı anahtarın farklı gövdeyle gelişini reddetmelidir; traveldistro'da bu, IDEMPOTENCY_CONFLICT koduyla 409 döner. Tekrar davranışının tamamı için idempotency rehberine ve güvenilirlik sayfasına bakın.