عرض مسبق فقط — يلزم التفعيل

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

FFast يكشف الشكل API المقصود دون تشغيل المكالمات العامة.يقوم مشغل بتفعيل وثائق الاعتماد والحصص المقاسة بعد فحص التكامل المقترح.

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

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

FFast يقترب من مضيف API من خلال وثائق الاعتماد المنشطة بالدعم ، ثم نقطة نهاية مستأجرة مخصصة. يحافظ الاستعراض السريع على مسار استدعاء صراحة للخادم فقط.

عنوان URL المستأجرhttps://ffast.app
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلFfastPipeline
إصدار APIv1
# 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 من التخزين السري لجانب الخادم قبل عدم تضمين حزمة العميل. هذا الاستعراض السريع يجعل أيضًا عدم وجود سجلات عامة أو مستودعات واضحة.

02

حل رابط

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 من القيمة المرجعية غير المتغيرة قبل توفر كل رابط. هذا الاستعراض السريع يجعل أيضًا أي علامة جودة تخمينية واضحة.

03

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

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"}'
1202 مقبولةحفظ pipeline_run.
2حالة الاستفتاءGET /v1/jobs/{pipeline_run} بنفس المفتاح.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
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. تغطي الرؤية التالية الركود المقفل. تحتفظ الصفحة بالتسليم المؤقت الموقع مرئيًا.

04

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

مراجعة سريعة 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الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

FFast تنشيط الحصص المقاسة التي تحافظ على استجابة التسليم دون وضع حمولة غير آمنة على المنصات الصاعدة.

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

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

تنشيط من خلال الدعم

امنح FFast ملخصًا موجزًا للمنتج وإسقاطًا للحركة وقائمة بالمنصات.حدد ما إذا كانت هناك حاجة إلى فحوصات البيانات الوصفية أو الوظائف المعدة أو كليهما بحيث يتطابق المفتاح الصادر مع سير العمل الفعلي.

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