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

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

Insto بصری-میڈیا انضمام کا بلیوپرنٹ جانچ کے لیے پیش کرتا ہے۔ سپورٹ کی جانب سے ٹیننٹ-اسکوپڈ اجازت دینے تک لائیو تجزیہ اور جاب درخواستیں دستیاب نہیں رہتیں۔

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

فوری آغاز

API میزبان کے لیے، Insto سپورٹ-فعال اسناد کے ساتھ شروع ہوتا ہے۔ اس کا ڈاؤن لوڈ جائزہ اسے ایک تفویض شدہ tenant اینڈپوائنٹ کے ساتھ جوڑتا ہے اور سرور-مخصوص کال پاتھ پر ختم ہوتا ہے۔

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

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

Insto اسناد کی حفاظت کے لیے تین عملی نکات پیش کرتا ہے۔ پہلا سرور سائڈ خفیہ ذخیرہ ہے۔ ڈاؤن لوڈ جائزہ پھر کلائنٹ بنڈل میں ایمبیڈنگ نہ ہونے کا احاطہ کرتا ہے۔ اس کا آخری نکتہ عوامی لاگز یا ریپوزٹریز نہ ہونا ہے۔

02

لنک حل کریں

Resolve operation کے لیے، Insto ماخذ کی شناخت سے شروع ہوتا ہے۔ اس کی ڈاؤن لوڈ جائزہ ایک جمع کرائے گئے URL کے فارمیٹس کے ساتھ اسے جوڑتی ہے اور بغیر کسی گھڑت آؤٹ پٹس کے ختم ہوتی ہے۔

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

Insto فارمیٹ شناخت کنندہ کے لیے تین عملی نکات پیش کرتا ہے۔ پہلی بات واپس آنے والی قدر ہے جو جوں کی توں رہتی ہے۔ اس کے بعد ڈاؤن لوڈ جائزہ فی لنک دستیابی کا احاطہ کرتا ہے۔ اس کا آخری نکتہ یہ ہے کہ معیار کا کوئی اندازہ شدہ لیبل نہیں ہوتا۔

03

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

Insto جاب کی تخلیق کو غیر ہم آہنگ تیاری کے گرد منظم کرتا ہے۔ اس کا ڈاؤن لوڈ جائزہ ایک مختصر HTTP درخواست سے موازنہ کرتا ہے۔ محدود ورکر عمل درآمد آخری جانچ رہتا ہے۔

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

Insto میں، جاب پولنگ کی وضاحت کرتے وقت ایک سیکنڈ کا ابتدائی انتظار پہلے آتا ہے۔ اس کے بعد وہ ڈاؤن لوڈ جائزہ محدود بیک آف کے ساتھ آتا ہے اور عارضی دستخط شدہ ترسیل پر ختم ہوتا ہے۔

04

متوقع غلطیاں

Error contract کی وضاحت کے لیے، Insto ایک non-2xx envelope کو support request ID سے الگ کرتا ہے۔ ایک download review پیش گوئی کے قابل 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

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

Insto کال کی حدیں بصری-میڈیا کے استعمال کے معاملے اور ان نیٹ ورکس کے مطابق ڈھالتا ہے جن سے منظور شدہ کلائنٹ رابطہ کرے گا۔

اسکیمہ تک رسائی کے لیے، Insto تلاش سے پہلے فعال کاری کے ساتھ شروع ہوتا ہے۔ اس کی ڈاؤن لوڈ جائزہ اسے تفویض شدہ تصدیق کے ساتھ جوڑتا ہے اور دستاویزی درخواست کی ساختوں پر ختم ہوتا ہے۔

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

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

منصوبہ بند بصری-میڈیا پروڈکٹ، متوقع ماہانہ استعمال اور جن پوسٹ اقسام کو آپ سنبھالنے کا ارادہ رکھتے ہیں، ان کی وضاحت کریں۔ Insto صرف ضروری تجزیہ یا تیاری کے اسکوپس دیتا ہے اور کبھی بھی قابلِ مطالعہ ٹوکن محفوظ نہیں کرتا۔

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