https://quickdl.appQuickDL کے ساتھ ڈاؤن لوڈز بنائیں
QuickDL ڈویلپرز کو ایکٹیویشن سے پہلے مختصر درخواست ماڈل کا معائنہ کرنے دیتا ہے۔ سپورٹ کو پروڈکٹ کی توثیق کرنی ہوگی اس سے پہلے کہ نجی کلید اور کوٹہ قابلِ استعمال ہوں۔
فوری آغاز
QuickDL میں، API host کی وضاحت کرتے وقت support-activated credentials پہلے آتے ہیں۔ یہ مختصر utility اس کے بعد assigned tenant endpoint کے ساتھ آتی ہے اور server-only call path پر ختم ہوتی ہے۔
X-API-Key: pending_activation_…QuickDlJobsv1# 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 کو نظر میں نہیں رکھتا۔
لنک حل کریں
QuickDL میں، Resolve آپریشن کی وضاحت کرتے وقت ماخذ کا پتہ لگانا پہلے آتا ہے۔ یہ مختصر یوٹیلٹی ایک جمع کرائے گئے URL سے فارمیٹس کے ساتھ آگے بڑھتی ہے اور کسی بھی اختراعی آؤٹ پٹس پر ختم نہیں ہوتی۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
public_link | HTTPS یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL Format identifier کو پہلے واپس آنے والی قدر کو جوں کا توں شناخت کرکے سنبھالتا ہے۔ اس کے بعد یہ ہر لنک کی دستیابی پر عمل کرتا ہے اور کوئی اندازہ شدہ معیار کا لیبل نظر میں نہیں رکھتا۔
ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں
QuickDL کی کمپیکٹ یوٹیلیٹی غیر ہم زمانی تیاری کا جائزہ Job creation کے لیے لیتی ہے۔ یہ اگلے مرحلے میں ایک مختصر HTTP درخواست دکھاتی ہے اور محدود worker execution کو مخفی نہیں کرتی۔
/v1/jobsدائرہ کار: ملازمتیں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
public_link | HTTPS یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
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"}'quick_job.GET /v1/jobs/{quick_job} اسی کلید کے ساتھ۔| حیثیت | معنی | کلائنٹ کا عمل |
|---|---|---|
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 جاب پولنگ کے لیے تین عملی نکات پیش کرتا ہے۔ پہلے ایک سیکنڈ کا ابتدائی انتظار آتا ہے۔ پھر مختصر یوٹیلیٹی محدود بیک آف کا احاطہ کرتی ہے۔ اس کا آخری نکتہ عارضی دستخط شدہ ترسیل ہے۔
متوقع غلطیاں
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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
QuickDL ایک مختصر، کلائنٹ-مخصوص کوٹہ فراہم کرتا ہے جو سورس سروسز کو غیر مستحکم کیے بغیر انضمام کی حمایت کرتا ہے۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
QuickDL میں، Schema تک رسائی کی وضاحت کرتے وقت ایکسپلوریشن سے پہلے ایکٹیویشن آتی ہے۔ یہ مختصر یوٹیلٹی تفویض شدہ تصدیق کے بعد آتی ہے اور دستاویزی درخواست کی ساختوں پر ختم ہوتی ہے۔
سپورٹ کے ذریعے فعال کریں
QuickDL کو انضمام کا نام، متوقع ماہانہ حجم، اور مطلوبہ ذرائع فراہم کریں۔ ان کارروائیوں کی شناخت کریں جو سرور انجام دے گا تاکہ منظوری سے ایک محدود دائرہ کار والی، ایک بار استعمال ہونے والی کلید بنے۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔