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

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

ذیل میں دیا گیا Insts ورک بینچ ایک ممکنہ کلائنٹ کے لیے دستاویزات ہے۔ کوئی قابلِ عمل سند یا کال اجازت بننے سے پہلے آپریٹر کا جائزہ لیا جاتا ہے۔

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

فوری آغاز

API ہوسٹ Insts پر سپورٹ-ایکٹیویٹڈ اسناد کے ساتھ شروع ہوتا ہے۔ اگلا منظر ایک تفویض شدہ ٹیننٹ اینڈپوائنٹ کا احاطہ کرتا ہے۔ صفحہ سرور-صرف کال پاتھ کو مرئی رکھتا ہے۔

کرایہ دار کا URLhttps://insts.io
تصدیقX-API-Key: pending_activation_…
کلائنٹ پروفائلInstsConnect
API ورژنv1
# 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 پر اسناد کی حفاظت کے لیے سرور سائیڈ خفیہ ذخیرہ ابتدائی نقطہ ہے۔ اس کے بعد ایک معائنہ بینچ کوئی کلائنٹ بنڈل ایمبیڈنگ پیش نہیں کرتا اور کوئی عوامی لاگز یا ریپوزٹریز نہیں دکھاتا۔

02

لنک حل کریں

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

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

Insts پر فارمیٹ شناخت کنندہ کے لیے نقطۂ آغاز وہی لوٹائی گئی غیر تبدیل شدہ قدر ہے۔ اس کے بعد ایک معائنہ بینچ فی لنک دستیابی پیش کرتا ہے اور کسی بھی اندازہ شدہ معیار کا لیبل نہیں بتاتا۔

03

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

Insts ملازمت کی تخلیق کو آسانی سے اسکین کرنے کے قابل بناتا ہے۔ صفحہ غیر ہم آہنگ تیاری سے شروع ہوتا ہے، ایک مختصر HTTP درخواست کی طرف بڑھتا ہے، اور واضح طور پر محدود ورکر عمل درآمد کو بیان کرتا ہے۔

پوسٹ/v1/jobsدائرہ کار: ملازمتیں
فیلڈقسمضروریتفصیل
shared_postHTTPS یو آر ایلہاںاسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔
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"}'
1202 منظور شدہمحفوظ کریں connect_job.
2رائے شماری کی حالتGET /v1/jobs/{connect_job} اسی کلید کے ساتھ۔
3تیاردستخط شدہ ڈاؤن لوڈ URL کھولیں۔
حیثیتمعنیکلائنٹ کا عمل
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 ایک سیکنڈ کی ابتدائی انتظار کی جانچ کرتا ہے اس سے پہلے کہ محدود بیک آف ہو۔ یہ معائنے کی بینچ عارضی دستخط شدہ ترسیل کو بھی واضح کرتی ہے۔

04

متوقع غلطیاں

خرابی کا معاہدہ 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قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔
05

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

Insts جائزے کے وقت شرح کی حدود قائم کرتا ہے تاکہ معائنہ کے کام کی جگہ اور ہر فراہم کنندہ روٹ کی حفاظت کی جا سکے۔

Insts پر دریافت سے پہلے فعال کاری کے ساتھ اسکیما تک رسائی شروع ہوتی ہے۔ اگلا منظر تفویض شدہ توثیق کا احاطہ کرتا ہے۔ صفحہ دستاویزی درخواست کی ساختیں نمایاں رکھتا ہے۔

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

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

ورک بینچ کے استعمال کے کیس، متوقع کال گنتی، اور زیرِ معائنہ خدمات شیئر کریں۔ Insts اس حد کا جائزہ لیتا ہے اس سے پہلے کہ ٹیننٹ کی اسناد ایک بار ظاہر کی جائے اور اسے ایک محفوظ شدہ ہیش میں تبدیل کر دیا جائے۔

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