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

# التفرّد

> استخدم رؤوس Idempotency-Key ثابتة على طلبات الكتابة حتى تبقى عمليات إعادة المحاولة آمنة ومن دون تكرار.

# التفرّد

تقبل جميع نقاط نهاية التغيير `POST` و `PATCH` رأسًا اختياريًا باسم `Idempotency-Key`.

## متى ترسله

استخدم مفتاح التفرّد عندما:

* قد يعيد العميل المحاولة بعد فشل في النقل.
* قد يرسل عامل قائمة الانتظار العملية المنطقية نفسها أكثر من مرة.
* قد يعيد وكيل الذكاء الاصطناعي تنفيذ عملية تغيير بعد تقدم جزئي أو بسبب إعادة محاولات الأداة.

## النمط الموصى به

* أنشئ مفتاحًا ثابتًا واحدًا لكل عملية تغيير منطقية.
* أعد استخدام المفتاح نفسه عند إعادة المحاولة لتلك العملية.
* غيّر المفتاح عندما تتغير العملية المقصودة.

## أمثلة

```http theme={null}
Idempotency-Key: create-project-song-1
```

```http theme={null}
Idempotency-Key: export-song-1
```

## حدود جيدة

* مفتاح واحد لإنشاء مشروع.
* مفتاح مختلف لتصدير ذلك المشروع.
* مفتاح مختلف مرة أخرى لتحديث إعدادات المشروع.

يساعد ذلك على إبقاء عمليات إعادة المحاولة آمنة من دون إلغاء تكرار أعمال غير مرتبطة عن طريق الخطأ.