تحويل ملف

نقطة وصول واحدة تؤدي العمل. أرسل ملفًا وصيغة هدف، فتستلم مهمة — منجزة إن كانت سريعة، وفي الطابور إن لم تكن كذلك.

المصادقة

تتطلب كل نقاط الوصول عدا فهرس الصيغ مفتاح واجهة برمجة يُرسَل كرمز bearer. أنشئ واحدًا من صفحة «الأتمتة» في حسابك؛ ويُعرض مرة واحدة ولا يُخزَّن إلا كبصمة، ولذلك لا يمكن استرجاع مفتاح فقدته — أصدر بدلًا منه مفتاحًا جديدًا.

والوصول إلى واجهة البرمجة جزء من خطة Plus. ومفتاح حسابٍ لا يملكها يُرفض برمز NOT_ENTITLED.

Authorization: Bearer rlv_your_key_here

الطلب

‏POST https://rework.live/api/v1/convert، بصيغة multipart/form-data، بحقلين اثنين بالضبط: صيغة الهدف والملف نفسه. وترتيب الحقول غير مهم.

curl -X POST https://rework.live/api/v1/convert \
  -H "Authorization: Bearer rlv_your_key_here" \
  -F "to=webp" \
  -F "file=@photo.png"

الحقل	النوع	الوصف
to	string	معرّف صيغة الهدف، مثل `pdf` أو `webp` أو `mp4`
file	file	الملف المراد تحويله. ملف واحد لكل طلب.

الاستجابة

دائمًا JSON، ولا تكون بايتات خامًا أبدًا، وبالشكل نفسه دائمًا سواء اكتمل التحويل أو دخل الطابور. فالعميل المضطر إلى التفريع بحسب نوع المحتوى ليعرف ما استلمه هو عميل سيخطئ في النهاية.

ويعني 200 أن المهمة تمّت وأن download جاهز. ويعني 202 أنها دخلت الطابور: فـ status_url هو موضع الاستعلام، وdownload يساوي null حتى تكتمل.

{
  "job": {
    "id": "6a84860000000000000000ab",
    "status": "done",
    "from": "png",
    "to": "webp",
    "bytes": 48213,
    "durationMs": 412,
    "notes": [],
    "expiresAt": "2026-09-03T10:22:31.000Z",
    "download": "https://rework.live/api/v1/jobs/6a84860000000000000000ab/download",
    "status_url": null,
    "queuePosition": null,
    "estimateMs": null
  }
}

الحصول على البايتات مباشرة

أضف ?download=1 إن كنت تفضّل الملف على الرابط. عندئذٍ يُرجع التحويل الذي ينتهي فورًا البايتات؛ أما الذي يدخل الطابور فيظل يُرجع 202 مع JSON، لأنه لا يوجد بعد ما يُرسَل.