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

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

QuickDL ڈویلپرز کو ایکٹیویشن سے پہلے مختصر درخواست ماڈل کا معائنہ کرنے دیتا ہے۔ سپورٹ کو پروڈکٹ کی توثیق کرنی ہوگی اس سے پہلے کہ نجی کلید اور کوٹہ قابلِ استعمال ہوں۔

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

فوری آغاز

QuickDL میں، API host کی وضاحت کرتے وقت support-activated credentials پہلے آتے ہیں۔ یہ مختصر utility اس کے بعد assigned tenant endpoint کے ساتھ آتی ہے اور server-only call path پر ختم ہوتی ہے۔

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

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

QuickDL سرور سائیڈ خفیہ ذخیرہ کاری کی پہلے شناخت کرکے Credential safety کو سنبھالتا ہے۔ اس کے بعد یہ client bundle میں embedding نہ ہونے کی پیروی کرتا ہے اور کسی public logs یا repositories کو نظر میں نہیں رکھتا۔

02

لنک حل کریں

QuickDL میں، Resolve آپریشن کی وضاحت کرتے وقت ماخذ کا پتہ لگانا پہلے آتا ہے۔ یہ مختصر یوٹیلٹی ایک جمع کرائے گئے URL سے فارمیٹس کے ساتھ آگے بڑھتی ہے اور کسی بھی اختراعی آؤٹ پٹس پر ختم نہیں ہوتی۔

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

QuickDL Format identifier کو پہلے واپس آنے والی قدر کو جوں کا توں شناخت کرکے سنبھالتا ہے۔ اس کے بعد یہ ہر لنک کی دستیابی پر عمل کرتا ہے اور کوئی اندازہ شدہ معیار کا لیبل نظر میں نہیں رکھتا۔

03

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

QuickDL کی کمپیکٹ یوٹیلیٹی غیر ہم زمانی تیاری کا جائزہ Job creation کے لیے لیتی ہے۔ یہ اگلے مرحلے میں ایک مختصر HTTP درخواست دکھاتی ہے اور محدود worker execution کو مخفی نہیں کرتی۔

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

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

04

متوقع غلطیاں

QuickDL ایک غیر 2xx لفافے کے ذریعے Error contract کے قریب آتا ہے، پھر ایک support request ID۔ یہ مختصر utility متوقع client handling کو واضح رکھتی ہے۔

{
  "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

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

QuickDL ایک مختصر، کلائنٹ-مخصوص کوٹہ فراہم کرتا ہے جو سورس سروسز کو غیر مستحکم کیے بغیر انضمام کی حمایت کرتا ہے۔

QuickDL میں، Schema تک رسائی کی وضاحت کرتے وقت ایکسپلوریشن سے پہلے ایکٹیویشن آتی ہے۔ یہ مختصر یوٹیلٹی تفویض شدہ تصدیق کے بعد آتی ہے اور دستاویزی درخواست کی ساختوں پر ختم ہوتی ہے۔

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

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

QuickDL کو انضمام کا نام، متوقع ماہانہ حجم، اور مطلوبہ ذرائع فراہم کریں۔ ان کارروائیوں کی شناخت کریں جو سرور انجام دے گا تاکہ منظوری سے ایک محدود دائرہ کار والی، ایک بار استعمال ہونے والی کلید بنے۔

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