فهرس الصيغ

نقطة وصول عامة واحدة بلا مصادقة تُرجع كل ما نحوّله وكل مسار بين الصيغ. ابنِ واجهتك انطلاقًا منها بدل تثبيت قائمة في الشيفرة.

لا حاجة إلى مفتاح

‏GET https://rework.live/api/v1/formats لا يحتاج إلى مصادقة. فهو قائمة قدرات لا بيانات، واشتراط مفتاح لمجرد معرفة ما تحوّله خدمة ما هو جفاء صغير — ويعني كذلك أن أحدًا لا يستطيع تقييم الواجهة قبل الدفع مقابلها.

والاستجابة قابلة للتخزين المؤقت لمدة ساعة. اطلبها عند الإقلاع لا مع كل طلب.

curl https://rework.live/api/v1/formats

ما الذي يعود

مصفوفتان. تصف formats كل صيغة نستطيع قراءتها أو كتابتها؛ وconversions هي كل حافة بينها.

{
  "formats": [
    {
      "id": "png",
      "label": "PNG",
      "kind": "image",
      "extensions": ["png"],
      "mime": "image/png"
    }
  ],
  "conversions": [
    {
      "from": "png",
      "to": "webp",
      "fidelity": "high",
      "async": false,
      "maxInputMb": 200,
      "options": []
    }
  ]
}

الحقل	الوصف
from / to	معرّفا الصيغتين اللتين تصلهما الحافة
fidelity	مدى أمانة التحويل للأصل
async	صحيح حين يدخل هذا التحويل الطابور بدل تنفيذه فورًا
maxInputMb	أكبر مُدخل يقبله هذا التحويل تحديدًا
options	معاملات إضافية يقبلها هذا التحويل، إن وُجدت

سقفان لا سقف واحد

‏maxInputMb هو سقف ذلك التحويل تحديدًا. ولخطتك سقفها الخاص، والمطبَّق هو الأصغر بينهما. فمقطع فيديو بحجم 400 ميغابايت على حساب Plus يفشل رغم ذلك إن كان التحويل نفسه يقبل أقل.