https://quickt.ioQuickT کے ساتھ ڈاؤنلوڈز بنائیں
QuickT اس بات کی وضاحت کرتا ہے کہ ایک موبائل کلائنٹ سروس کے ساتھ کیسے رابطہ کرے گا۔ جب تک سپورٹ ڈیزائن کی منظوری نہ دے اور محدود رسائی کو فعال نہ کرے، یہ پیداواری کام جمع نہیں کرا سکتا۔
فوری آغاز
API میزبان کے لیے، QuickT تفویض شدہ tenant endpoint سے پہلے support-activated credentials کو چیک کرتا ہے۔ یہ device-ready منظر server-only call path کو بھی واضح کرتا ہے۔
X-API-Key: pending_activation_…QuicktRoutev1# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"
curl -X POST https://quickt.io/v1/resolve \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickT سرور-سائیڈ خفیہ ذخیرہ کے گرد Credential کی حفاظت کو منظم کرتا ہے۔ اس کا ڈیوائس-ریڈی منظر کلائنٹ بنڈل ایمبیڈنگ نہیں دکھاتا۔ کوئی عوامی لاگز یا ریپوزٹریز آخری جانچ رہتے ہیں۔
لنک حل کریں
Resolve آپریشن کے لیے، QuickT ایک جمع کرائے گئے URL سے فارمیٹس سے پہلے سورس ڈیٹیکشن چیک کرتا ہے۔ یہ ڈیوائس کے لیے تیار ویو بھی کسی بھی گھڑی ہوئی آؤٹ پٹس کو واضح نہیں کرتا۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
route_source | HTTPS یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickT فارمیٹ شناخت کنندہ کو واپس آنے والی قدر کے گرد بغیر تبدیلی کے منظم کرتا ہے۔ اس کا آلہ-تیار منظر فی-لنک دستیابی کا موازنہ کرتا ہے۔ کوئی اندازہ شدہ معیار کا لیبل آخری جانچ کے طور پر باقی نہیں رہتا۔
ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں
جاب کی تخلیق کی وضاحت کے لیے، QuickT غیر ہم آہنگ تیاری کو ایک مختصر HTTP درخواست سے الگ کرتا ہے۔ ایک ڈیوائس کے لیے تیار منظر bounded worker execution کو اس کی اپنی جگہ دیتا ہے۔
/v1/jobsدائرہ کار: ملازمتیں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
route_source | HTTPS یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
route_format | سٹرنگ | ہاں | ریسولو جواب سے ایک درست شناخت۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
curl -X POST https://quickt.io/v1/jobs \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'route_job.GET /v1/jobs/{route_job} اسی کلید کے ساتھ۔| حیثیت | معنی | کلائنٹ کا عمل |
|---|---|---|
queued | محدود قطار میں داخل کیا گیا۔ | دوبارہ پول کریں بیک آف کے ساتھ۔ |
extracting | ذریعہ میٹا ڈیٹا یا راستہ تازہ کیا جا رہا ہے۔ | پولنگ جاری رکھیں۔ |
processing | ڈاؤن لوڈ، ری مکس یا مرج کر رہے ہیں۔ | سرور کی پیش رفت دکھائیں۔ |
ready | دستخط شدہ ڈاؤن لوڈ دستیاب ہے۔ | URL صارف کو بھیجیں۔ |
failed | ٹرمینل ساختہ خرابی۔ | پڑھیں error_code. صرف مشورہ دیے جانے پر دوبارہ کوشش کریں۔ |
expired | عارضی آؤٹ پٹ ہٹا دیا گیا۔ | نیا کام بنائیں۔ |
curl https://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"QuickT پر جاب پولنگ کے لیے ایک سیکنڈ کی ابتدائی انتظار مدت آغاز نقطہ ہے۔ اس کے بعد ڈیوائس-ریڈی منظر محدود بیک آف پیش کرتا ہے اور عارضی دستخط شدہ ڈیلیوری کی وضاحت کرتا ہے۔
متوقع غلطیاں
Error contract کے لیے، QuickT ایک non-2xx envelope سے شروع ہوتا ہے۔ اس کا device-ready view اسے support request ID کے ساتھ جوڑتا ہے اور predictable 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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
QuickT منظوری کے دوران موبائل کلائنٹ حدود منتخب کرتا ہے تاکہ تخلیق کار نیٹ ورکس اور API جواب دہ رہیں۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
اسکیما تک رسائی کے لیے، QuickT تلاش سے پہلے، تفویض شدہ تصدیق سے پہلے ایکٹیویشن کی جانچ کرتا ہے۔ یہ ڈیوائس کے لیے تیار منظر دستاویزی درخواست کی ساختوں کو بھی واضح کرتا ہے۔
سپورٹ کے ذریعے فعال کریں
موبائل تجربے، اس کی ٹریفک کی توقع اور درکار کریئیٹر نیٹ ورکس کی وضاحت کریں۔ QuickT اس معلومات کو تجزیہ اور قطار کی اجازتیں تفویض کرنے کے لیے استعمال کرتا ہے، پھر راز کو ایک بار ظاہر کرتا ہے۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔