Preview only — activation required

Build downloads with EasyF

EasyF shows the interface in advance so developers can estimate their work. A support review is still required before a live key and usage boundary exist.

EasyfClientJSON عبر HTTPSوظائف غير متزامنةوثائق التفويض المحددة النطاق

البداية السريعة

To explain API host, EasyF separates support-activated credentials from an assigned tenant endpoint. A plain-language workflow gives a server-only call path its own place.

عنوان URL المستأجرhttps://easyf.app

التوثيقX-API-Key: pending_activation_…

نبذة عن العميلEasyfClient

إصدار APIv1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

curl -X POST https://easyf.app/v1/resolve \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Credential safety starts with server-side secret storage on EasyF. The next view covers no client bundle embedding. The page keeps no public logs or repositories visible.

حل رابط

To explain Resolve operation, EasyF separates source detection from formats from one submitted URL. A plain-language workflow gives no invented outputs its own place.

الوظائف/v1/resolveالنطاق: حل

الميدان	نوع المشروع	المطلوب	وصف المشروع
`asset_url`	عنوان URL HTTPS	نعم	صفحة وسائل الإعلام العامة أو المأذون بها لتحليل.
`tenant`	سلسلة	لا	نطاق المستأجر المخصص.عادة ما يتم حذفه.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Format identifier starts with the returned value unchanged on EasyF. The next view covers per-link availability. The page keeps no guessed quality label visible.

إنشاء ومتابعة عمل التنزيل

EasyF presents three practical points for Job creation. First comes asynchronous preparation. The plain-language workflow then covers a short HTTP request. Its final point is bounded worker execution.

الوظائف/v1/jobsالنطاق: الوظائف

الميدان	نوع المشروع	المطلوب	وصف المشروع
`asset_url`	عنوان URL HTTPS	نعم	نفس المصدر المُطّبيع المقدم لحلّ.
`variant_code`	سلسلة	نعم	معرف دقيق من استجابة الحل.
`tenant`	سلسلة	لا	نطاق المستأجر المخصص.عادة ما يتم حذفه.

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 مقبولةSave delivery_id.

2حالة الاستفتاءGET /v1/jobs/{delivery_id} with the same key.

3جاهزافتح عنوان URL للتنزيل الموقّع.

ألف - الحالة	المعنى	إجراءات العملاء
`queued`	تم القبول في الطابور المحدود.	استطلاع رأي مرة أخرى مع التراجع.
`extracting`	تحديث البيانات الوصفية المصدر أو الطريق.	واصلوا التصويت.
`processing`	التنزيل أو إعادة المزج أو الدمج.	عرض تقدم الخادم.
`ready`	تحميل موقع متاح.	أرسل عنوان URL إلى المستخدم.
`failed`	خطأ مهيكلة المحطة الطرفية.	Read `error_code`. Retry only when advised.
`expired`	أزيل الناتج المؤقت.	إنشاء وظيفة جديدة.

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF approaches Job polling through one-second initial wait, then capped backoff. The plain-language workflow keeps temporary signed delivery explicit.

الأخطاء المتوقعة

EasyF organizes Error contract around one non-2xx envelope. Its plain-language workflow compares a support request ID. Predictable client handling remains the final check.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

بروتوكول نقل الملفات السريع	المعنى النموذجي	الإجراء
400	عنوان URL غير صحيح أو جسم أو تنسيق غير متاح.	تصحيح الطلب.حل مرة أخرى للأشكال.
401	مفتاح مفقود أو غير صالح أو منتهية الصلاحية أو ذات نطاق خاطئ.	تحقق من وثائق الاعتماد على جانب الخادم.
403	رفضت سياسة المستأجر أو المصدر الطلب.	لا تتجاوز السياسة اتصل بالدعم.
404	وظيفة غير معروفة أو منتهية الصلاحية.	قم بإنشاء وظيفة جديدة إذا كان ذلك مناسبًا.
429	طلب أو حد الوظائف النشطة تم الوصول إليه.	Honor `retry_after_seconds`.
503	الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.	حاول مرة أخرى مع التراجع الأسي والتذبذب.

عقد التشغيل

EasyF agrees practical usage bounds with each approved product to preserve a predictable guided workflow.

استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
Use bounded exponential backoff with jitter for 429, 503 and retryable errors.
لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.

To explain Schema access, EasyF separates activation before exploration from assigned authentication. A plain-language workflow gives documented request shapes its own place.

الوصول الذي يستعرضه المشغل

Activate through support

Tell EasyF what you are building, how often it will call the API and which providers matter. The review decides the permitted operations, then reveals a credential once while saving only its secure digest.

Request activation المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.