https://insto.appInsto کے ساتھ ڈاؤن لوڈز بنائیں
Insto بصری-میڈیا انضمام کا بلیوپرنٹ جانچ کے لیے پیش کرتا ہے۔ سپورٹ کی جانب سے ٹیننٹ-اسکوپڈ اجازت دینے تک لائیو تجزیہ اور جاب درخواستیں دستیاب نہیں رہتیں۔
فوری آغاز
API میزبان کے لیے، Insto سپورٹ-فعال اسناد کے ساتھ شروع ہوتا ہے۔ اس کا ڈاؤن لوڈ جائزہ اسے ایک تفویض شدہ tenant اینڈپوائنٹ کے ساتھ جوڑتا ہے اور سرور-مخصوص کال پاتھ پر ختم ہوتا ہے۔
X-API-Key: pending_activation_…InstoMediav1# 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 اسناد کی حفاظت کے لیے تین عملی نکات پیش کرتا ہے۔ پہلا سرور سائڈ خفیہ ذخیرہ ہے۔ ڈاؤن لوڈ جائزہ پھر کلائنٹ بنڈل میں ایمبیڈنگ نہ ہونے کا احاطہ کرتا ہے۔ اس کا آخری نکتہ عوامی لاگز یا ریپوزٹریز نہ ہونا ہے۔
لنک حل کریں
Resolve operation کے لیے، Insto ماخذ کی شناخت سے شروع ہوتا ہے۔ اس کی ڈاؤن لوڈ جائزہ ایک جمع کرائے گئے URL کے فارمیٹس کے ساتھ اسے جوڑتی ہے اور بغیر کسی گھڑت آؤٹ پٹس کے ختم ہوتی ہے۔
/v1/resolveدائرہ کار: حل کریں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
media_source | HTTPS یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
tenant | سٹرنگ | نہیں | تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Insto فارمیٹ شناخت کنندہ کے لیے تین عملی نکات پیش کرتا ہے۔ پہلی بات واپس آنے والی قدر ہے جو جوں کی توں رہتی ہے۔ اس کے بعد ڈاؤن لوڈ جائزہ فی لنک دستیابی کا احاطہ کرتا ہے۔ اس کا آخری نکتہ یہ ہے کہ معیار کا کوئی اندازہ شدہ لیبل نہیں ہوتا۔
ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں
Insto جاب کی تخلیق کو غیر ہم آہنگ تیاری کے گرد منظم کرتا ہے۔ اس کا ڈاؤن لوڈ جائزہ ایک مختصر HTTP درخواست سے موازنہ کرتا ہے۔ محدود ورکر عمل درآمد آخری جانچ رہتا ہے۔
/v1/jobsدائرہ کار: ملازمتیں| فیلڈ | قسم | ضروری | تفصیل |
|---|---|---|---|
media_source | HTTPS یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
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"}'prepare_id.GET /v1/jobs/{prepare_id} اسی کلید کے ساتھ۔| حیثیت | معنی | کلائنٹ کا عمل |
|---|---|---|
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 میں، جاب پولنگ کی وضاحت کرتے وقت ایک سیکنڈ کا ابتدائی انتظار پہلے آتا ہے۔ اس کے بعد وہ ڈاؤن لوڈ جائزہ محدود بیک آف کے ساتھ آتا ہے اور عارضی دستخط شدہ ترسیل پر ختم ہوتا ہے۔
متوقع غلطیاں
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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
Insto کال کی حدیں بصری-میڈیا کے استعمال کے معاملے اور ان نیٹ ورکس کے مطابق ڈھالتا ہے جن سے منظور شدہ کلائنٹ رابطہ کرے گا۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
اسکیمہ تک رسائی کے لیے، Insto تلاش سے پہلے فعال کاری کے ساتھ شروع ہوتا ہے۔ اس کی ڈاؤن لوڈ جائزہ اسے تفویض شدہ تصدیق کے ساتھ جوڑتا ہے اور دستاویزی درخواست کی ساختوں پر ختم ہوتا ہے۔
سپورٹ کے ذریعے فعال کریں
منصوبہ بند بصری-میڈیا پروڈکٹ، متوقع ماہانہ استعمال اور جن پوسٹ اقسام کو آپ سنبھالنے کا ارادہ رکھتے ہیں، ان کی وضاحت کریں۔ Insto صرف ضروری تجزیہ یا تیاری کے اسکوپس دیتا ہے اور کبھی بھی قابلِ مطالعہ ٹوکن محفوظ نہیں کرتا۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔