https://insts.ioInsts کے ساتھ ڈاؤن لوڈ بنائیں
ذیل میں دیا گیا Insts ورک بینچ ایک ممکنہ کلائنٹ کے لیے دستاویزات ہے۔ کوئی قابلِ عمل سند یا کال اجازت بننے سے پہلے آپریٹر کا جائزہ لیا جاتا ہے۔
فوری آغاز
API ہوسٹ Insts پر سپورٹ-ایکٹیویٹڈ اسناد کے ساتھ شروع ہوتا ہے۔ اگلا منظر ایک تفویض شدہ ٹیننٹ اینڈپوائنٹ کا احاطہ کرتا ہے۔ صفحہ سرور-صرف کال پاتھ کو مرئی رکھتا ہے۔
X-API-Key: pending_activation_…InstsConnectv1# Available only after support activation
export INSTS_CONNECT_SECRET="issued-after-review"
curl -X POST https://insts.io/v1/resolve \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID"}'Insts پر اسناد کی حفاظت کے لیے سرور سائیڈ خفیہ ذخیرہ ابتدائی نقطہ ہے۔ اس کے بعد ایک معائنہ بینچ کوئی کلائنٹ بنڈل ایمبیڈنگ پیش نہیں کرتا اور کوئی عوامی لاگز یا ریپوزٹریز نہیں دکھاتا۔
لنک حل کریں
Insts پر ماخذ کی شناخت سے Resolve آپریشن شروع ہوتا ہے۔ اگلا منظر ایک جمع کرائے گئے URL سے فارمیٹس کا احاطہ کرتا ہے۔ صفحہ کوئی گھڑی ہوئی آؤٹ پٹس مرئی نہیں رکھتا۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
shared_post | HTTPS یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Insts پر فارمیٹ شناخت کنندہ کے لیے نقطۂ آغاز وہی لوٹائی گئی غیر تبدیل شدہ قدر ہے۔ اس کے بعد ایک معائنہ بینچ فی لنک دستیابی پیش کرتا ہے اور کسی بھی اندازہ شدہ معیار کا لیبل نہیں بتاتا۔
ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں
Insts ملازمت کی تخلیق کو آسانی سے اسکین کرنے کے قابل بناتا ہے۔ صفحہ غیر ہم آہنگ تیاری سے شروع ہوتا ہے، ایک مختصر HTTP درخواست کی طرف بڑھتا ہے، اور واضح طور پر محدود ورکر عمل درآمد کو بیان کرتا ہے۔
/v1/jobsدائرہ کار: ملازمتیں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
shared_post | HTTPS یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
asset_option | سٹرنگ | ہاں | ریسولو جواب سے ایک درست شناخت۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
curl -X POST https://insts.io/v1/jobs \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'connect_job.GET /v1/jobs/{connect_job} اسی کلید کے ساتھ۔| حیثیت | معنی | کلائنٹ کا عمل |
|---|---|---|
queued | محدود قطار میں داخل کیا گیا۔ | دوبارہ پول کریں بیک آف کے ساتھ۔ |
extracting | ذریعہ میٹا ڈیٹا یا راستہ تازہ کیا جا رہا ہے۔ | پولنگ جاری رکھیں۔ |
processing | ڈاؤن لوڈ، ری مکس یا مرج کر رہے ہیں۔ | سرور کی پیش رفت دکھائیں۔ |
ready | دستخط شدہ ڈاؤن لوڈ دستیاب ہے۔ | URL صارف کو بھیجیں۔ |
failed | ٹرمینل ساختہ خرابی۔ | پڑھیں error_code. صرف مشورہ دیے جانے پر دوبارہ کوشش کریں۔ |
expired | عارضی آؤٹ پٹ ہٹا دیا گیا۔ | نیا کام بنائیں۔ |
curl https://insts.io/v1/jobs/CONNECT_JOB \
-H "X-API-Key: $INSTS_CONNECT_SECRET"جاب پولنگ کے لیے، Insts ایک سیکنڈ کی ابتدائی انتظار کی جانچ کرتا ہے اس سے پہلے کہ محدود بیک آف ہو۔ یہ معائنے کی بینچ عارضی دستخط شدہ ترسیل کو بھی واضح کرتی ہے۔
متوقع غلطیاں
خرابی کا معاہدہ Insts پر ایک غیر-2xx لفافے کے ساتھ شروع ہوتا ہے۔ اس کے بعد یہ معائنہ بینچ ایک سپورٹ درخواست آئی ڈی پیش کرتا ہے۔ آخری حقیقت قابلِ پیش گوئی کلائنٹ ہینڈلنگ ہے۔
{
"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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
Insts جائزے کے وقت شرح کی حدود قائم کرتا ہے تاکہ معائنہ کے کام کی جگہ اور ہر فراہم کنندہ روٹ کی حفاظت کی جا سکے۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
Insts پر دریافت سے پہلے فعال کاری کے ساتھ اسکیما تک رسائی شروع ہوتی ہے۔ اگلا منظر تفویض شدہ توثیق کا احاطہ کرتا ہے۔ صفحہ دستاویزی درخواست کی ساختیں نمایاں رکھتا ہے۔
سپورٹ کے ذریعے فعال کریں
ورک بینچ کے استعمال کے کیس، متوقع کال گنتی، اور زیرِ معائنہ خدمات شیئر کریں۔ Insts اس حد کا جائزہ لیتا ہے اس سے پہلے کہ ٹیننٹ کی اسناد ایک بار ظاہر کی جائے اور اسے ایک محفوظ شدہ ہیش میں تبدیل کر دیا جائے۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔