> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# İdempotans

> Herhangi bir yazma işlemini bir şeyi iki kez oluşturmadan güvenle yeniden dene

## Mevcut bir kaynağı değiştiren yazma işlemleri

Herhangi bir başlık gerekmez. Eskiden hata döndüren bir tekrar, artık mevcut durumu döndürür:

| Uç nokta | Tekrarlanan çağrının yanıtı |
| - | - |
| [Randevuyu iptal et](https://docs.anivahealth.com/tr/api/appointments/cancel-appointment.md) | İptal edilen randevuyla birlikte `200` |
| [Gönderiyi iptal et](https://docs.anivahealth.com/tr/api/shipments/cancel-shipment.md) | İptal edilen gönderiyle birlikte `200` |
| [Evde test kiti siparişini iptal et](https://docs.anivahealth.com/tr/api/home-kit-orders/cancel-home-kit.md) | İptal edilen siparişle birlikte `200` |
| [Evde test kiti siparişini etkinleştir](https://docs.anivahealth.com/tr/api/home-kit-orders/activate-home-kit.md) | Örnek alma zamanı aynıysa `200` |
| Panel veya biyobelirteç kaldırma | Hâlâ ekli olup olmadıklarına bakılmaksızın `200` |

Bir tekrar hiçbir şey yazmaz ve yanıtı `Idempotent-Replayed: true` başlığını taşır — "bunu ben iptal ettim" ile "zaten iptal edilmişti" arasındaki farkı bu başlıkla anlarsın.

Üç istisna bunun yerine `409` döndürür:

* ***Farklı* bir `activated_at` ile etkinleştirme.** Laboratuvar raporunda yer alan bilgi örnek alma zamanıdır, bu nedenle yeni bir deneme bunun üzerine sessizce yazmamalıdır.
* **Zaten iptal edilmiş bir randevuyu *farklı* bir `cancellation_reason` ile iptal etme.** Aynı mantık: kayıtlı neden o zamandan beri düzeltilmiş olabilir ve yeni bir deneme bunun üzerine yazmamalıdır. Kayıtlı nedeni yeniden gönder veya alanı ekleme.
* **Geri dönüşü olmayan noktadan sonra iptal etme** — onaylanmış bir kan alma, teslim alınmış bir gönderi, kargoya verilmiş veya etkinleştirilmiş bir kit.

Üç uç nokta bilinçli olarak yeniden denemeye güvenli değildir:

* [Kan almayı onayla](https://docs.anivahealth.com/tr/api/appointments/confirm-blood-draw.md) — ikinci bir çağrı `409` döndürür.
* [Sonuçları e-postayla gönder](https://docs.anivahealth.com/tr/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) ve [Sonuçları e-postayla gönder](https://docs.anivahealth.com/tr/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — her çağrı bir e-posta gönderir. Zaman aşımı veya `5xx` sonrası yeniden deneme müşteriye yinelenen bir e-posta gönderebilir.

## Yeni kaynak oluşturan yazma işlemleri

Beş uç nokta en fazla 255 karakter uzunluğunda isteğe bağlı bir `Idempotency-Key` başlığı kabul eder:

* [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md)
* [Randevu oluştur](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md)
* [Evde test kiti siparişi oluştur](https://docs.anivahealth.com/tr/api/home-kit-orders/create-home-kit.md)
* [Gönderi oluştur](https://docs.anivahealth.com/tr/api/shipments/create-shipment.md)
* [Belge yükle](https://docs.anivahealth.com/tr/api/documents/upload-document.md)

Tek anahtar, dört deneme, tek sipariş — geri alacağın yanıt ne zaman yeniden denediğine ve gövdenin eşleşip eşleşmediğine bağlıdır:

![Sıralı diyagram: İlk istekten 350 ms sonra gönderilen yinelenen istek, ilk istek hâlâ çalışırken 409 yanıtı alır; ilk istek 201 döndürür; aynı anahtarla daha sonra yapılan yeniden deneme Idempotent-Replayed işaretli aynı siparişi döndürür ve değiştirilmiş gövdeyle aynı anahtar 409 döndürür.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Anahtarlar API anahtarına **ve** uç noktaya göre kapsamlandırılır; bu yüzden başka bir iş ortağının anahtarlarıyla veya başka bir yerde kullanılan aynı anahtarla asla çakışmaz.

* **Aynı anahtar, aynı gövde** → 24 saat boyunca `Idempotent-Replayed: true` işaretli ilk yanıtı geri alırsın. Alan sırası ve boşluklar önemli değildir.
* **Aynı anahtar, farklı gövde** → `409`.
* **Boş bir `Idempotency-Key`** → yok sayılmak yerine `400`.

### Anahtar ne zaman serbest bırakılır

Oluşturma işlemi **atomik değildir** — bir `5xx` yanıtı hiçbir şey yazılmadığı anlamına gelmez.

* **İstek herhangi bir şey oluşturulmadan önce başarısız olduysa** → anahtar serbest bırakılır, yani aynı anahtarla yeniden deneyebilirsin.
* **İstek bir şey oluşturulduktan sonra başarısız olduysa** veya **hiç yanıt dönmediyse** → anahtar ayrılmış kalır ve yeniden denemeler `409` alır. Var olup olmadığını kontrol etmek için kaynağı getir, yoksa yeni bir anahtar kullan.

> [!NOTE]
>
> Bir tekrar yanıtı, kaynak oluşturulduğunda kaydedilen yanıt gövdesini döndürür — canlı bir okuma
> değil, anlık görüntüdür. Kaynak o zamandan beri değiştiyse doğrudan kaynağı getir.

### Bazı oluşturma işlemlerinin doğal bir anahtarı da vardır

İki uç nokta, herhangi bir başlıktan bağımsız olarak yinelenen istekleri kendi başına reddeder:

* [Randevu oluştur](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md) her profil, konum ve zaman noktası için tek bir randevuya izin verir. Bir tekrar, mevcut `appointment_id` değerini taşıyan `409` döndürür.
* [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md), `email` adresine ait bir profil zaten varsa `409` döndürür. `email` alanını eklemezsen her istek için benzersiz bir yer tutucu oluşturulur, bu yüzden tekrarlar *gerçekten de* ayrı profiller oluşturur.

Her ikisi de geçerli olduğunda gördüğün yanıt doğal anahtar kaynaklı `409` olur ve ek alanı (`appointment_id` veya bir `error_name` ayırt edicisi) yalnızca o taşır — idempotency kaynaklı `409` yalnızca `error` taşır, bu yüzden bu alanları temkinli oku.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.