https://downf.iodownf.io کے ساتھ ڈاؤنلوڈز بنائیں
DownF API کے عمل کو اس وقت تک غیر فعال رکھتا ہے جب تک کہ ایک آپریٹر مطابقت کے استعمال کے کیس کا جائزہ نہ لے۔ مثالیں منصوبہ بند معاہدے کی وضاحت کرتی ہیں، جبکہ اصل اسناد اور کوٹے صرف سپورٹ ایکٹیویشن کے ذریعے فراہم ہوتے ہیں۔
فوری آغاز
DownF سپورٹ سے فعال کردہ اسناد کے گرد API ہوسٹ کو منظم کرتا ہے۔ اس کا مطابقتی منظر ایک تفویض شدہ ٹیننٹ اینڈ پوائنٹ کا موازنہ کرتا ہے۔ صرف سرور والا کال پاتھ آخری جانچ کے طور پر باقی رہتا ہے۔
X-API-Key: pending_activation_…DownfBridgev1# 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 پر شروع ہوتی ہے۔ یہ مطابقتی منظر پھر کلائنٹ بنڈل ایمبیڈنگ پیش نہیں کرتا۔ آخری حقیقت یہ ہے کہ کوئی عوامی لاگز یا ریپوزٹریاں نہیں ہیں۔
لنک حل کریں
DownF ریزولو آپریشن کو سورس ڈیٹیکشن کے گرد منظم کرتا ہے۔ اس کا مطابقتی منظر ایک جمع کرائے گئے URL سے فارمیٹس کا موازنہ کرتا ہے۔ کوئی گھڑی گئی آؤٹ پٹس حتمی جانچ کے طور پر باقی نہیں رہتیں۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
media_address | HTTPS یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}فارمیٹ شناخت کنندہ واپس کردہ قدر کے ساتھ بغیر تبدیلی کے DownF پر شروع ہوتا ہے۔ پھر یہ مطابقتی منظر فی-لنک دستیابی پیش کرتا ہے۔ آخری حقیقت یہ ہے کہ معیار کا کوئی اندازہ لگایا ہوا لیبل نہیں۔
ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں
جاب کی تخلیق DownF پر غیر ہم وقت ساز تیاری سے شروع ہوتی ہے۔ اگلا منظر ایک مختصر HTTP درخواست کا احاطہ کرتا ہے۔ صفحہ محدود ورکر عمل درآمد کو مرئی رکھتا ہے۔
/v1/jobsدائرہ کار: ملازمتیں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
media_address | HTTPS یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
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"}'transfer_ref.GET /v1/jobs/{transfer_ref} اسی کلید کے ساتھ۔| حیثیت | معنی | کلائنٹ کا عمل |
|---|---|---|
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 کا مطابقتی منظر جاب پولنگ کے لیے ایک سیکنڈ کے ابتدائی انتظار کا جائزہ لیتا ہے۔ یہ اگلا محدود بیک آف دکھاتا ہے اور عارضی دستخط شدہ ترسیل کو نہیں چھپاتا۔
متوقع غلطیاں
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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
DownF مطلوبہ کلائنٹ کا جائزہ لینے کے بعد درخواست کی حد مقرر کرتا ہے، اور اپنی مطابقت کی جانچ اور بالائی فراہم کنندگان کو مستحکم رکھتا ہے۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
DownF اسکیمہ تک رسائی کو دریافت سے پہلے فعال کرنے کے گرد منظم کرتا ہے۔ اس کا مطابقتی منظر تفویض کردہ توثیق کا موازنہ کرتا ہے۔ دستاویزی درخواست کی ساخت آخری جانچ بنی رہتی ہے۔
سپورٹ کے ذریعے فعال کریں
پروڈکٹ کی وضاحت کریں، اس کی ماہانہ کالز کی پیش گوئی کریں اور وہ پلیٹ فارمز درج کریں جن کا اسے تجزیہ کرنا ضروری ہے۔ DownF سپورٹ ایک بار نظر آنے والے اسناد جاری کرنے سے پہلے مطلوبہ اسکوپس کی تصدیق کرے گی، جس کی محفوظ شدہ نقل صرف ایک ہیش ہوگی۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔