الاستعلام والتنزيل

يمنحك التحويل الذي يدخل الطابور معرّف مهمة. وهاتان النقطتان تخبرانك متى صار جاهزًا وتسلّمانك الملف.

التحقق من الحالة

‏GET https://rework.live/api/v1/jobs/:id، بالرمز bearer نفسه. وما دامت المهمة منتظرة فستحصل أيضًا على موضعها في الطابور وتقدير للمدة، بحيث يمكن للعميل أن يعرض ما هو أنفع من مؤشّر تحميل دوّار.

curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
  -H "Authorization: Bearer rlv_your_key_here"
الحالةالمعنى
queuedبانتظار عامل. queuePosition مضبوط.
runningقيد التحويل الآن.
doneاكتملت. download جاهز.
failedلم تُحوَّل. ولم يُحتسب شيء على حصتك.

تنزيل النتيجة

‏GET https://rework.live/api/v1/jobs/:id/download يُرجع البايتات المحوَّلة بنوع المحتوى الصحيح واسم ملف. ويعمل حتى انتهاء صلاحية المهمة، وهو ما تحدّده مدة الاحتفاظ في خطتك.

curl -L -o converted.webp \
  https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
  -H "Authorization: Bearer rlv_your_key_here"

المهام ملك للمفاتيح

لا يستطيع حساب أن يقرأ مهمة أنشأها حساب آخر. وطلب مهمة تخص شخصًا آخر يُرجع 404 لا 403، وهذا مقصود: فمعرّف المهمة قابل للتخمين بما يكفي لأن يكشف التمييز بين «ليست لك» و«غير موجودة» أن تحويلات الآخرين موجودة.

استعلم على فترات معقولة — فالتقدير الوارد في الاستجابة موجود ليضبط إيقاعك. والاستعلام في حلقة متلاحقة يُحتسب على حدّك الساعي كأي طلب آخر.