https://ffast.appبناء التنزيلات مع FFast
FFast يكشف الشكل API المقصود دون تشغيل المكالمات العامة.يقوم مشغل بتفعيل وثائق الاعتماد والحصص المقاسة بعد فحص التكامل المقترح.
البداية السريعة
FFast يقترب من مضيف API من خلال وثائق الاعتماد المنشطة بالدعم ، ثم نقطة نهاية مستأجرة مخصصة. يحافظ الاستعراض السريع على مسار استدعاء صراحة للخادم فقط.
X-API-Key: pending_activation_…FfastPipelinev1# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"
curl -X POST https://ffast.app/v1/resolve \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'لسلامة Credential ، يتحقق FFast من التخزين السري لجانب الخادم قبل عدم تضمين حزمة العميل. هذا الاستعراض السريع يجعل أيضًا عدم وجود سجلات عامة أو مستودعات واضحة.
حل رابط
FFast يقرب من حل العملية من خلال اكتشاف المصدر ، ثم تنسيقات من عنوان URL واحد مقدم. يحافظ الاستعراض السريع على عدم وجود مخرجات مخترعة صريحة.
/v1/resolveالنطاق: حل| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
fast_source | عنوان URL HTTPS | نعم | صفحة وسائل الإعلام العامة أو المأذون بها لتحليل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}بالنسبة لمعرف الشكل ، يتحقق FFast من القيمة المرجعية غير المتغيرة قبل توفر كل رابط. هذا الاستعراض السريع يجعل أيضًا أي علامة جودة تخمينية واضحة.
إنشاء ومتابعة عمل التنزيل
FFast يتعامل مع إنشاء الوظيفة من خلال تحديد أول إعداد غير متزامن. يتبع مع طلب HTTP قصير ويحافظ على تنفيذ العامل المحدود في الرؤية.
/v1/jobsالنطاق: الوظائف| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
fast_source | عنوان URL HTTPS | نعم | نفس المصدر المُطّبيع المقدم لحلّ. |
output_code | سلسلة | نعم | معرف دقيق من استجابة الحل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
curl -X POST https://ffast.app/v1/jobs \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'pipeline_run.GET /v1/jobs/{pipeline_run} بنفس المفتاح.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
queued | تم القبول في الطابور المحدود. | استطلاع رأي مرة أخرى مع التراجع. |
extracting | تحديث البيانات الوصفية المصدر أو الطريق. | واصلوا التصويت. |
processing | التنزيل أو إعادة المزج أو الدمج. | اعرض تقدم معالجة الخادم. |
ready | تحميل موقع متاح. | أرسل عنوان URL إلى المستخدم. |
failed | خطأ مهيكلة المحطة الطرفية. | قراءة error_code.حاول مرة أخرى فقط عندما ينصح. |
expired | أزيل الناتج المؤقت. | إنشاء وظيفة جديدة. |
curl https://ffast.app/v1/jobs/PIPELINE_RUN \
-H "X-API-Key: $FFAST_PIPELINE_KEY"يبدأ استطلاع الوظائف مع الانتظار الأولي لمدة ثانية واحدة على FFast. تغطي الرؤية التالية الركود المقفل. تحتفظ الصفحة بالتسليم المؤقت الموقع مرئيًا.
الأخطاء المتوقعة
مراجعة سريعة FFast مراجعات غلاف واحد غير 2xx لعقد الخطأ. يظهر معرف طلب دعم فيما يلي ولا يحجب معالجة العميل المتوقعة.
{
"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 | طلب أو حد الوظائف النشطة تم الوصول إليه. | الشرف retry_after_seconds. |
| 503 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
FFast تنشيط الحصص المقاسة التي تحافظ على استجابة التسليم دون وضع حمولة غير آمنة على المنصات الصاعدة.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- استخدام الارتداد الأسي المحدود مع التشتت لـ
429,503والأخطاء القابلة لإعادة المحاولة. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
FFast تقترب من الوصول إلى Schema من خلال التنشيط قبل الاستكشاف ، ثم خصصت المصادقة.المراجعة السريعة تحافظ على أشكال الطلب الموثقة صريحة.
تنشيط من خلال الدعم
امنح FFast ملخصًا موجزًا للمنتج وإسقاطًا للحركة وقائمة بالمنصات.حدد ما إذا كانت هناك حاجة إلى فحوصات البيانات الوصفية أو الوظائف المعدة أو كليهما بحيث يتطابق المفتاح الصادر مع سير العمل الفعلي.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.