https://ffast.appFFast کے ساتھ ڈاؤنلوڈز بنائیں
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"}'شناختی اسناد کی حفاظت کے لیے، FFast کلائنٹ بنڈل میں شامل کیے بغیر سرور سائیڈ خفیہ ذخیرہ چیک کرتا ہے۔ یہ تیز جائزہ عوامی لاگز یا ریپوزٹریوں کو بھی واضح نہیں کرتا۔
لنک حل کریں
FFast ماخذ کی شناخت کے ذریعے Resolve عمل تک پہنچتا ہے، پھر ایک جمع کرائے گئے URL سے فارمیٹ کرتا ہے۔ تیز جائزہ کسی بھی من گھڑت آؤٹ پٹس کو واضح نہیں رکھتا۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
fast_source | 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 | 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 کا تیز جائزہ Error معاہدے کے لیے ایک غیر-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": "…"
}| HTTP | معمول کا مطلب | عمل |
|---|---|---|
| 400 | غلط URL، مواد یا غیر دستیاب فارمیٹ۔ | درخواست درست کریں۔ فارمیٹس کے لیے دوبارہ حل کریں۔ |
| 401 | گمشدہ، غیر معتبر، ختم شدہ یا غلط دائرۂ کار والی کلید۔ | سرور سائیڈ کی سند چیک کریں۔ |
| 403 | کرایہ دار یا ماخذ پالیسی نے درخواست مسترد کر دی۔ | پالیسی کو نظرانداز نہ کریں۔ سپورٹ سے رابطہ کریں۔ |
| 404 | نامعلوم یا ختم شدہ کام۔ | اگر مناسب ہو تو ایک نیا کام بنائیں۔ |
| 429 | درخواست یا فعال کام کی حد پہنچ گئی ہے۔ | عزت retry_after_seconds. |
| 503 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
FFast ناپی ہوئی کوٹائیں فعال کرتا ہے جو ہینڈ آف کو جوابدہ رکھتی ہیں بغیر اپ اسٹریم پلیٹ فارمز پر غیر محفوظ بوجھ ڈالے۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
FFast ایکسپلوریشن سے پہلے ایکٹیویشن کے ذریعے Schema تک رسائی حاصل کرتا ہے، پھر اسائن کردہ تصدیق۔ تیز جائزہ دستاویزی درخواست کی شکلوں کو واضح رکھتا ہے۔
سپورٹ کے ذریعے فعال کریں
FFast کے لیے ایک مختصر پروڈکٹ خلاصہ، ٹریفک پروجیکشن اور پلیٹ فارم کی فہرست دیں۔ واضح کریں کہ آیا میٹاڈیٹا چیکس، تیار شدہ جابز یا دونوں درکار ہیں تاکہ جاری کردہ کی اصل ورک فلو سے مطابقت رکھے۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔