الانتقال إلى المحتوى الرئيسي

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

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

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

تقبل هذه النقاط النهائية العمل وتُرجِع معرّفات يمكنك استطلاعها:
  • 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 لتنزيل التصدير على أنها قابلة للتحديث بدلًا من دائمة.