صرف پیش نظارہ — فعال سازی ضروری ہے

downf.io کے ساتھ ڈاؤنلوڈز بنائیں

DownF API کے عمل کو اس وقت تک غیر فعال رکھتا ہے جب تک کہ ایک آپریٹر مطابقت کے استعمال کے کیس کا جائزہ نہ لے۔ مثالیں منصوبہ بند معاہدے کی وضاحت کرتی ہیں، جبکہ اصل اسناد اور کوٹے صرف سپورٹ ایکٹیویشن کے ذریعے فراہم ہوتے ہیں۔

DownfBridgeHTTPS پر JSONغیر ہم وقت نوکریاںمحدود اسناد
01

فوری آغاز

DownF سپورٹ سے فعال کردہ اسناد کے گرد API ہوسٹ کو منظم کرتا ہے۔ اس کا مطابقتی منظر ایک تفویض شدہ ٹیننٹ اینڈ پوائنٹ کا موازنہ کرتا ہے۔ صرف سرور والا کال پاتھ آخری جانچ کے طور پر باقی رہتا ہے۔

کرایہ دار کا URLhttps://downf.io
تصدیقX-API-Key: pending_activation_…
کلائنٹ پروفائلDownfBridge
API ورژنv1
# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"

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

کریڈینشل کی حفاظت سرور سائیڈ خفیہ ذخیرہ کاری سے DownF پر شروع ہوتی ہے۔ یہ مطابقتی منظر پھر کلائنٹ بنڈل ایمبیڈنگ پیش نہیں کرتا۔ آخری حقیقت یہ ہے کہ کوئی عوامی لاگز یا ریپوزٹریاں نہیں ہیں۔

02

لنک حل کریں

DownF ریزولو آپریشن کو سورس ڈیٹیکشن کے گرد منظم کرتا ہے۔ اس کا مطابقتی منظر ایک جمع کرائے گئے URL سے فارمیٹس کا موازنہ کرتا ہے۔ کوئی گھڑی گئی آؤٹ پٹس حتمی جانچ کے طور پر باقی نہیں رہتیں۔

پوسٹ/v1/resolveدائرہ کار: حل کریں
فیلڈقسمضروریتفصیل
media_addressHTTPS یو آر ایلہاںتجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔
tenantسٹرنگنہیںتفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

فارمیٹ شناخت کنندہ واپس کردہ قدر کے ساتھ بغیر تبدیلی کے DownF پر شروع ہوتا ہے۔ پھر یہ مطابقتی منظر فی-لنک دستیابی پیش کرتا ہے۔ آخری حقیقت یہ ہے کہ معیار کا کوئی اندازہ لگایا ہوا لیبل نہیں۔

03

ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں

جاب کی تخلیق DownF پر غیر ہم وقت ساز تیاری سے شروع ہوتی ہے۔ اگلا منظر ایک مختصر HTTP درخواست کا احاطہ کرتا ہے۔ صفحہ محدود ورکر عمل درآمد کو مرئی رکھتا ہے۔

پوسٹ/v1/jobsدائرہ کار: ملازمتیں
فیلڈقسمضروریتفصیل
media_addressHTTPS یو آر ایلہاںاسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔
output_refسٹرنگہاںریسولو جواب سے ایک درست شناخت۔
tenantسٹرنگنہیںتفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔
curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'
1202 منظور شدہمحفوظ کریں transfer_ref.
2رائے شماری کی حالتGET /v1/jobs/{transfer_ref} اسی کلید کے ساتھ۔
3تیاردستخط شدہ ڈاؤن لوڈ URL کھولیں۔
حیثیتمعنیکلائنٹ کا عمل
queuedمحدود قطار میں داخل کیا گیا۔دوبارہ پول کریں بیک آف کے ساتھ۔
extractingذریعہ میٹا ڈیٹا یا راستہ تازہ کیا جا رہا ہے۔پولنگ جاری رکھیں۔
processingڈاؤن لوڈ، ری مکس یا مرج کر رہے ہیں۔سرور کی پیش رفت دکھائیں۔
readyدستخط شدہ ڈاؤن لوڈ دستیاب ہے۔URL صارف کو بھیجیں۔
failedٹرمینل ساختہ خرابی۔پڑھیں error_code. صرف مشورہ دیے جانے پر دوبارہ کوشش کریں۔
expiredعارضی آؤٹ پٹ ہٹا دیا گیا۔نیا کام بنائیں۔
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF کا مطابقتی منظر جاب پولنگ کے لیے ایک سیکنڈ کے ابتدائی انتظار کا جائزہ لیتا ہے۔ یہ اگلا محدود بیک آف دکھاتا ہے اور عارضی دستخط شدہ ترسیل کو نہیں چھپاتا۔

04

متوقع غلطیاں

DownF Error contract کے لیے تین عملی نکات پیش کرتا ہے۔ سب سے پہلے ایک غیر-2xx لفافہ آتا ہے۔ اس کے بعد مطابقتی منظر ایک سپورٹ درخواست ID کا احاطہ کرتا ہے۔ اس کا آخری نکتہ متوقع کلائنٹ ہینڈلنگ ہے۔

{
  "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قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔
05

عملیاتی معاہدہ

DownF مطلوبہ کلائنٹ کا جائزہ لینے کے بعد درخواست کی حد مقرر کرتا ہے، اور اپنی مطابقت کی جانچ اور بالائی فراہم کنندگان کو مستحکم رکھتا ہے۔

DownF اسکیمہ تک رسائی کو دریافت سے پہلے فعال کرنے کے گرد منظم کرتا ہے۔ اس کا مطابقتی منظر تفویض کردہ توثیق کا موازنہ کرتا ہے۔ دستاویزی درخواست کی ساخت آخری جانچ بنی رہتی ہے۔

آپریٹر-جائزہ شدہ رسائی

سپورٹ کے ذریعے فعال کریں

پروڈکٹ کی وضاحت کریں، اس کی ماہانہ کالز کی پیش گوئی کریں اور وہ پلیٹ فارمز درج کریں جن کا اسے تجزیہ کرنا ضروری ہے۔ DownF سپورٹ ایک بار نظر آنے والے اسناد جاری کرنے سے پہلے مطلوبہ اسکوپس کی تصدیق کرے گی، جس کی محفوظ شدہ نقل صرف ایک ہیش ہوگی۔

فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔