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