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

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

یہ EasyT حوالہ ایک نفاذی رہنما ہے، نہ کہ ایک فعال گمنام اینڈپوائنٹ۔ پیداواری رسائی صرف تب شروع ہوتی ہے جب سپورٹ کلائنٹ کی منظوری دے اور حدود مقرر کرے۔

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

فوری آغاز

API میزبان EasyT پر سپورٹ-ایکٹیویٹڈ اسناد کے ساتھ شروع ہوتا ہے۔ یہ رہنمائی شدہ جانچ پھر ایک تفویض شدہ ٹیننٹ اینڈپوائنٹ پیش کرتی ہے۔ آخری حقیقت ایک سرور-صرف کال پاتھ ہے۔

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

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

EasyT میں، Credential کی حفاظت کی وضاحت کرتے وقت سرور سائیڈ خفیہ ذخیرہ پہلے آتا ہے۔ اس کے بعد رہنما جانچ ہوتی ہے جس میں کوئی کلائنٹ بنڈل ایمبیڈنگ نہیں ہوتی اور آخر میں کوئی عوامی لاگز یا ریپوزٹریز نہیں ہوتے۔

02

لنک حل کریں

Resolve کا عمل EasyT پر ماخذ کی شناخت سے شروع ہوتا ہے۔ یہ رہنمائی شدہ جانچ پھر ایک جمع شدہ URL سے فارمیٹس پیش کرتی ہے۔ آخری حقیقت یہ ہے کہ کوئی گھڑی ہوئی آؤٹ پٹس نہیں ہیں۔

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

EasyT میں، جب فارمیٹ شناخت کنندہ کی وضاحت کی جاتی ہے تو واپس آنے والی غیر تبدیل شدہ قدر پہلے آتی ہے۔ اس کے بعد رہنمائی شدہ جانچ فی-لنک دستیابی کے ساتھ آتی ہے اور کسی اندازہ شدہ معیار کے لیبل کے بغیر ختم ہوتی ہے۔

03

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

EasyT پر جاب بنانے کا آغاز غیر متزامن تیاری سے ہوتا ہے۔ اس کے بعد ایک رہنمائی شدہ چیک ایک مختصر HTTP درخواست پیش کرتا ہے اور محدود ورکر عملدرآمد کی وضاحت کرتا ہے۔

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

جاب پولنگ کے لیے، EasyT ایک سیکنڈ کی ابتدائی انتظار سے شروع ہوتا ہے۔ اس کی گائیڈڈ جانچ اسے محدود بیک آف کے ساتھ جوڑتی ہے اور عارضی دستخط شدہ ترسیل پر ختم ہوتی ہے۔

04

متوقع غلطیاں

EasyT Error contract کو آسانی سے اسکین کرنے کے قابل بناتا ہے۔ صفحہ ایک non-2xx envelope سے شروع ہوتا ہے، پھر support request ID کی طرف بڑھتا ہے، اور واضح طور پر قابلِ پیش گوئی 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

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

EasyT جائزے کے دوران ایک عملی اجازت کا انتخاب کرتا ہے، اور درخواست کی ضروریات کو فراہم کنندہ کی صحت کے ساتھ متوازن کرتا ہے۔

EasyT پر دریافت سے پہلے فعال کاری کے ساتھ اسکیمہ تک رسائی شروع ہوتی ہے۔ یہ رہنمائی شدہ جانچ پھر تفویض شدہ توثیق پیش کرتی ہے۔ آخری حقیقت دستاویزی درخواست کی ساختیں ہیں۔

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

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

ایکٹیویشن نوٹ میں کلائنٹ کا مقصد، متوقع ماہانہ ورک لوڈ اور درخواست کردہ نیٹ ورکس شامل کریں۔ اس کے بعد EasyT درست طور پر resolve اور job scopes منتخب کر سکتا ہے، اس سے پہلے کہ ایک one-view secret تیار کرے۔

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