> ## 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.

# المهام غير المتزامنة والاستطلاع

> افهم عمليات الكتابة القائمة على المهام، حالات المهام النهائية، وأي الموارد تحتفظ بحالة دائمة.

# المهام غير المتزامنة والاستطلاع

معظم عمليات الكتابة غير متزامنة.

## ما الذي يعود فورًا

تقبل هذه النقاط النهائية العمل وتُرجِع معرّفات يمكنك استطلاعها:

* `POST /projects`
* `POST /projects/{projectId}/tasks/stem-separation`
* `POST /projects/{projectId}/tasks/lyrics-sync`
* `POST /projects/{projectId}/exports`

## ما الذي يجب استطلاعه

* استطلع `GET /tasks/{taskId}` لمعرفة حالة التنفيذ ومخرجات المهمة المُعبّأة.
* اقرأ `GET /projects/{projectId}` للحصول على حالة المشروع طويلة الأمد.
* اقرأ `GET /exports/{exportId}` للحصول على عناوين URL حديثة لتنزيل التصدير.

## نموذج استطلاع عملي

1. ابدأ عملية تغيير وخزّن المعرّفات المُعادة.
2. استطلع `GET /tasks/{taskId}` حتى تصل المهمة إلى حالة نهائية.
3. أعد قراءة المورد الدائم عبر المعرّف بدلًا من الوثوق بحالة مخبأة قديمة.
4. للتنزيلات، اجلب `GET /exports/{exportId}` عندما تكون جاهزًا لاستخدام عنوان URL.

## لماذا يهم ذلك

* حالة المهمة هي الخط الزمني للتنفيذ.
* حالة المشروع هي مصدر الحقيقة الدائم.
* يجب التعامل مع عناوين URL لتنزيل التصدير على أنها قابلة للتحديث بدلًا من دائمة.