بناء التنزيلات مع EasyF

# 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"}'

تبدأ سلامة وثائق الاعتماد مع التخزين السري لجانب الخادم على EasyF. يشمل المنظر التالي لا دمج حزمة العميل. لا تحتفظ الصفحة بأي سجلات عامة أو مستودعات مرئية.

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

يبدأ معرف التنسيق مع القيمة المرجعية دون تغيير على EasyF. تغطي الرؤية التالية توافر لكل رابط. تحتفظ الصفحة بأي علامة جودة تخمينية مرئية.

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"}'

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

EasyF تقترب من استطلاع الوظائف من خلال الانتظار الأولي لمدة ثانية واحدة ، ثم التراجع المقفل. يحافظ تدفق العمل باللغة الواضحة على التسليم المؤقت الموقع بشكل صريح.

{
  "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": "…"
}

• استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
• تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
• استخدام الارتداد الأسي المحدود مع التشتت لـ 429, 503 والأخطاء القابلة لإعادة المحاولة.
• لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
• احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.

لشرح الوصول إلى Schema ، يفصل EasyF التنشيط قبل الاستكشاف عن المصادقة المخصصة.يمنح تدفق العمل بلغة واضحة أشكال الطلب الموثقة مكانها الخاص.